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Operating System Documents 
for Different Audiences 



As shown on the previous page, Altos offers many manuals with Altos UNIX System V — the manu- 
als you receive will depend on your configuration. To help you decide which manuals are best 
suited to your needs, we have listed below the manuals according to three broad groups of users. 

These lists are only suggested starting points in your search for information. They are not meant to 
imply that certain users should not read certain manuals. Find the user group that best applies to 
you, and use its list of manuals as a starting point for your reading, from which you can move on to 
other manuals. 

Note that every Run-time System includes five manuals: the Installation Guide, the User's Guide, 
the User's Reference, the System Administrator's Guide, and the System Administrator's Refer- 
ence. The Run-time System reference pages that describe the C, M, F, ADM, and HW commands 
("man pages") are provided online as well. If you have the Development System, all manuals 
listed under "For Programmers:" come with your operating system. (All Development System 
reference pages are also provided online.) To order additional manuals, call (408) 434-6688, exten- 
sion 3004 and give the manual title and part number. 



For General Users (especially Beginners): 

Tutorial 
User's Guide 

User's Reference (C, M, F) 
Using the AOM Menu System 

For System Administrators (and Advanced Users): 

Installation Guide 

System Administrator's Guide 

System Administrator's Reference (ADM, HW) 

International Operating System Guide 

Programmer's Reference (CP, S) 

For Programmers: 

Programmer's Guide 
Programmer's Reference (CP, S) 
C Language Guide 
Library Guide 
Developer's Guide 

CodeView and Macro Assembler User's Guide 
Device Driver Writer's Guide 



Preface 



Throughout the documentation, a given command, routine, or file is 
referred to by its name and a section (in parentheses). For example, the 
programming command cc, is listed as cc (CP), which indicates that cc is 
described in the Programming Commands (CP) section. 

There is a total of twelve reference sections in Altos UNIX System V, in 
different volumes of the Operating System and the Development System 
documents. (These reference sections are often called manual pages, or 
just man pages, in short.) For example, the cc (CP) command mentioned 
above is located in the CP section found in the Programmer's Reference . 

This document, the System Administrator's Reference (ADM, HW), is a 
companion to the System Administrator's Guide and contains all 
commands that are reserved for exclusive use by system administrators. 
This manual contains the following two reference sections: 



Section Description Volume 



ADM Administrative Commands - used System 



The following table lists the remaining reference sections, the type of 
commands they contain, and in which document each is located. 



for system administration. 



Administrator's 
Reference 



HW 



Hardware device manual pages - 
information about hardware 
devices and device nodes. 



System 

Administrator's 
Reference 



Section 



Description 



Volume 



C 



Commands - used with the 
Operating System. 



User's Reference 



Section 



Description 



Volume 



CP Programming Commands - used 

witli the Development System. 

DOS DOS Cross-development 
subroutines and libraries 

F File Formats - description of 

various system files not defined in 
section M. 

K Kernel routines - used for writing 

device drivers. 

M Miscellaneous - information used 

for access to devices, system 
maintenance, and communi- 
cations. 

NSL Network Services Library - used 
with the STREAMS System. 

S System Calls and Library 

Routines - available for C and 
assembly language programming. 

STR STREAMS manual pages 

XNX XENIX cross-development 
manual pages 



Programmer's Reference 
Developer's Guide 
User's Reference 



Device Driver Writer's 
Guide 

User's Reference 



Developer's Guide 
Programmer's Reference 

Developer's Guide 
Library Guide 



The alphabetized table of contents following this preface lists all Altos 
UNDC System V commands, system calls, library routines, and file 
formats. In addition, in the front of each individual reference section there 
is an alphabetized list of all the manual pages contained in that section. 

The permuted index, found at the end of all Reference manuals, is useful 
in matching a desired task with the manual page that describes it. It too is 
an organized list of all Altos UNIX System V commands, system calls, 
library routines, and file formats, but organized according to function, not 
alphabetically. Note that some pages in the Operating System documents 
refer to "include" files that are actually part of the Development System. 



Alphabetized List 



Commands, Systems Calls, Library Routines and File Formats 



300 300(C] 

4014 4014(C] 

450 450(C] 

86rel 86rel(F, 

_exit exit {S] 

a.out a.out(F] 

a641 a64l(S] 

abort abort(S] 

abs absis] 

accept accept (ADM] 

access access (S] 

acct acct(ADM] 

acct acct(F] 

acct acct{S] 

acctcms acctcms (ADM] 

acctcom acctcom(ADM] 

acctdisk acct (ADM] 

acctdusg acct (ADM] 

acctmerg acctmerg (ADM' 

accton acct(ADM] 

accton accton(ADM] 

acctprc acctprc (ADM] 

acctprcl acctprc (ADM] 

acctprc! acctprc (ADM] 

acctsh acctsh(ADM] 

acctwtmp acct (ADM] 

acos trig(S] 

adb adb(CP] 

add.vd add.vd(ADM] 

addxusers .... addxusers(ADM] 

adfmt adfrnt (ADM] 

admin admin(CP] 

alarm alarm(S] 

aom aom(is/L] 

ar ar(CP] 

ar ar(F] 

archive archive (F^ 

ascii ascii(M] 

asctime ctime(S] 

asin trig(S] 

asktime asktime (ADM; 



assert assert (S) 

assign assign(C) 

asx asx(CP) 

at at(C) 

atan trig(S) 

atanl trig(S) 

atcronsh atcronsh(ADM) 

atof atof(S) 

atof strtod(S) 

atoi atoflS) 

atoi strtol(S) 

atol atof(S) 

atoi strtol(S) 

audit audit (ADM[) 

auditcmd auditcmd(ADM) 

auditd auditd(ADM) 

auditsh auditsh(ADM) 

authcap authcap(F) 

authck authck(ADM) 

auths auths(C) 

authsh authsh(ADM) 

authsh authtsh(ADM) 

autoboot autoboot (ADM) 

awk awk(C) 

backup backup (ADM) 

backupsh backupsh(ADM) 

badtrk badtrk(ADM) 

banner banner(C) 

basename basename(C) 

batch at(C) 

be bc(C) 

bcheckrc brc (ADM) 

bdiff bdiff(C) 

bdos bdos(DOS) 

bessel bessel(S) 

bfs bfs(C) 

boot :..boot(}m) 

brc brc (ADM) 

brk sbrk(S) 

brkctl brkctl(S) 

bsearch bsearch(S) 



cal cal(C) 

calendar calendar (C) 

calloc rmlloc(S) 

cancel lp(C) 

captoinfo captoinfo (ADM) 

carcI_info card_info(F) 

cat cat(C) 

cb cb(CP) 

cc cc (CP) 

cd cd(C) 

cdc cdc(CP) 

cdrom ci/row(HW) 

ceil floor (S) 

cflow cflow(CP) 

cgets cgets(DOS) 

chargefee acctsh (ADM) 

chdir chdir(S) 

checkaddr .. checkaddr (ADM) 

checklist checklist (F) 

checkmail checkmail(C) 

checkque checkque (ADM) 

checkup checkup (ADM) 

chg_audit .... chg audit (ADM) 

chgrp chgrp(C) 

chmod chmod(C) 

chmod chmod(S) 

chown chown(C) 

chown chown(S) 

chroot chroot (ADM) 

chroot chroot (S) 

chrtbl chrtbl(M) 

chsize chsize(S) 

ckpacct acctsh(ADM) 

cleantmp cleantmp (ADM) 

clear clear (C) 

clearerr f error (S) 

clock clock (F) 

clock clock(S) 

close close (S) 

clone clone (M) 

closedir directory (S) 

clri dn (ADM) 

cmchk cmchk(C) 

cmos cmoj (HW) 

cmp cmp(C) 

col col(C) 



coltbl coltbKM) 

comb comb(CP) 

comm comm(C) 

compress compress (C) 

configure configure (ADM) 

console console (M) 

consoleprint. consoleprint (ADM) 

conv conv(S) 

convkey mapkey(M) 

copy copy(C) 

core core(F) 

cos trig(S) 

cosh sinh(S) 

cp cp(C) 

cpio cpio(C) 

cpio cpio(F) 

cpp cpp (CP) 

cprintf cprintf (DOS) 

cputs cputs (DOS) 

crash crash(ADM) 

creat creat(S) 

creatsem creatsem(S) 

cref cref (CP) 

cron cron(C) 

"crontab" "crontab"(C) 

crypt crypt(C) 

cscanf cscanf(DOS) 

csh csh(C) 

csplit csplit(C) 

ctags ctags (CP) 

ctermid ctermid(S) 

ctime ctime (S) 

ctype ctype(S) 

cu cu(C) 

curses curses (S) 

curtbl curtbl(M) 

cuserid cuserid(S) 

custom custom(ADM) 

cut cut(C) 

cvtcoif cvtcoff(M) 

cvtomf cvtomf(M) 

cxref cxref (CP) 

daemon.mn daemon.mn(M) 

date date(C) 

dbmbuild dbmbuild(ADM) 

dbminit dbm(S) 



ii 



dc dc(C) 

dcopy dcopy (ADM) 

dd dd(C) 

deassign assign(C) 

default default (F) 

defopen defopen(S) 

defread defopen (S) 

delete dbm(S) 

deliver deliver (ADM) 

delta delta (CP) 

deLvd del.vd(ADM) 

devices devices (F) 

devnm devnm(C) 

df df(C) 

dial dial(A\m) 

dial dial(S) 

dialcodes dialcodes(¥) 

dialers dialers (F) 

difiF diff(C) 

diff3 diJff3(C) 

dir dir(¥) 

dircmp dircmp(C) 

directory directory (S) 

dirent dirent(F) 

dirname dirname(C) 

disable disable (C) 

diskcmp diskcp(C) 

diskcp diskcp(C) 

diskusg diskusg(ADM) 

display display (HW) 

displaypkg . displaypkg (ADM) 

divvy divvy (ADM) 

dlayout dlayout (ADM) 

dlvr_audit .. dlvr audit (ADM) 

dmesg dmesg(ADM) 

dodisk acctsh(ADM) 

dos dos(C) 

doscat dos(C) 

doscp dos(C) 

dosdir dos(C) 

dosexterr dosexter (DOS) 

dosformat dos(C) 

dosld dosld(CP) 

dosls dos(C) 

dosmkdir dos(C) 

dosrm dos(C) 



dosrmdir ..dos(C) 

dparam dparam(ADM) 

drand48 drand48(S) 

dtox dtox(C) 

dtype dtype(C) 

du du(C) 

dumpdir dumpdir(C) 

dup dup(S) 

dup2 dup(S) 

echo echo(C) 

ecvt ecvt(S) 

ed ed(C) 

edata end(S) 

edit ejc(C) 

egrep grep(C) 

enable enable (C) 

end end(S) 

endgrent getgrent(S) 

endpwent getpwent(S) 

endutent getut(S) 

env env(C) 

environ environ (M) 

eof eof (DOS) 

erand48 drand48(S) 

erf erf(S) 

erfc erf(S) 

errno perror(S) 

error error(M) 

etext end(S) 

ev_block ev_block(S) 

ev_close ev close (S) 

ev_count ev count (S) 

ev_flush ev Jlush(S) 

ev_getdev ev_getdev(S) 

ev_getemask ev_gtemsk(S) 

ev_gindev ev_gindev(S) 

ev_init ev init (S) 

ev_open ev_open(S) 

ev_pop ev _pop(S) 

ev_read ev_read(S) 

ev_resume ev_resume(S) 

ev_setemask ev_stemsk(S) 

ev_suspend ev_susp(S) 

ex ex(C) 

execl exec(S) 

execle exec(S) 



111 



execlp ejcec(S) 

execseg execseg (S) 

execv exec(S) 

execve exec(S) 

execvp execls) 

exit exit(DOS) 

exit exit(S) 

exp expls) 

expr expr(C) 

fabs floor(S) 

factor factor (C) 

false false (C) 

fclose fclose(DOS) 

fclose fclose (S) 

fcloseall fclose (DOS) 

fconvert fconvertQA) 

fcntl fcntl(M) 

fcntl fcntl(S) 

fcvt ecvt(S) 

fd MHW) 

fdisk fdisk(ADM) 

fdopen fopen(S) 

fdswap fdswap(ADM) 

feof ferror(S) 

ferror ferror(S) 

fetch dbm(S) 

fflush fclose (S) 

fgetc /^g/c(DOS) 

fgetc getciS) 

fgetchar fgetc (DOS) 

fgets gets(S) 

fgrep grep(C) 

file ^/e(C) 

filehdr filehdr(F) 

filelength fileleng (DOS) 

fileno ferror (S) 

filesys filesys(F) 

filesystem filesystem(F) 

find find(C) 

finger finger (C) 

firstkey ift?m(S) 

fixhdr fixhdr(C) 

fixperm ^perm (ADM) 

floor floor(S) 

flushall ...flushall(DOS) 

fmod floor (S) 



fopen fopen(S) 

fork fork(S) 

format format(C) 

fp_ofl' fp_seg(DOS) 

fp_seg fp_seg(DOS) 

fprintf printf(S) 

fputc ^M/c(DOS) 

fputc putc(S) 

fputchar fputc (DOS) 

fputs puts(S) 

fread fread(S) 

free malloc(S) 

f reopen fopen(S) 

frexp frexp(S) 

fsave /^aveCADM) 

fscanf scanf(S) 

fsck fsck(ADM) 

fsdb /^rf^?(ADM) 

fseek fseek(S) 

fsname fsname(ADM) 

fspec fspec(F) 

fsphoto fsphoto (ADM) 

fsstat fsstat(ADM) 

fstat stat(S) 

fstatfs statfs(S) 

fstyp /^fypCADM) 

ftell fseek(S) 

ftime time(S) 

ftok stdipc(S) 

ftw ^(S) 

fuser fuser(C) 

fwrite fread(S) 

fwtmp ywfmp(ADM) 

fxlist xlist(S) 

gamma gamma(S) 

gcvt ecvt(S) 

get get(CV) 

getc ^e?c(S) 

getch getch(DOS) 

getchar getc(S) 

getche getche(J^OS) 

getclk getclk(}A) 

getcwd getcwd(S) 

getdents getdents(S) 

getegid getuid(S) 

getenv getenv(S) 



geteuid getuidiS 

getgid getuid(S 

getgrent getgrent(S 

getgrgid getgrent (S 

getgrnam getgrent (S 

gethostid gethostid(S 

getkernelid getsystemid(S 

getlogin getlogin(S 

getopt getopt(C 

getopt getopt (S 

getoptcvt getopt s(C 

getopts getopts(C 

getpass getpass(S 

getpgrp getpidls 

getpid getpid(S 

getppid getpidls 

getpw getpwls 

getpwent getpwent(S 

getpwnam getpwent (S 

getpwuid getpwent (S 

gets ^^^^(C 

gets getsiS 

getsystemid getsystemidls 

getty getty(}A. 

"gettydefs" " getty defs"{¥, 

getuid getuidls 

getut getutls 

getutent getutls 

getutid getutls 

getutline getutls 

getw getcls 

gmtime ctimels 

goodpw goodpw(ADM 

gps gps{F 

graph graph(ADM 

greek greek(C 

grep grep(C 

group group (F 

grpcheck grpcheck(C 

gsignal ssignal(S 

haltsys haltsys(ADM 

hashcheck spell (C 

hashmake spell Ic 

hcreate hsearch(S 

hd hd{C 

hd M(HW 



hdestroy hsearch(S) 

hdr hdr(CP) 

hdutil hdutil (ADM) 

head head(C) 

hello hello (C) 

help help(CP) 

hostid hostid(C) 

hp hp(C) 

hs hs(¥) 

hsearch hsearchiS) 

hwconfig hwconfigiC) 

hypot hypot(S) 

i286emul i286emul(C) 

i386 machidlC) 

id id(ADM) 

id id(C) 

idaddld idaddld(ADM) 

idbuild idbuildlADM) 

idcheck idcheck (ADM) 

idinstall idinstall (ADM) 

idleout idleoutiADM) 

idload idloadlADM) 

idmemtune . idmemtune (ADM) 

idmkinit idmkinit (ADM) 

idspace idspace (ADM) 

idtune idtunelAT>M) 

imacct imacct(C) 

infocmp infocmp (ADM) 

inir />«Y(M) 

init imf(M) 

initcond initcond{ATlM) 

inittab inittab(F) 

inode inode(F) 

inp m/7(D0S) 

install install (ADM) 

installpkg .... installpkg (ADM) 

mm int86(DOS) 

int86x int86x(DOS) 

intdos intdos (DOS) 

intdosx intdosx(DOS) 

integrity integrity (ADM) 

ioctl ioctl(S) 

ipcrm ipcrm(ADM) 

ipcs ipcs (ADM) 

ips ips (ADM) 

isalnum ctype (S) 



isalpha ctype(S) 

isascii ctype(S) 

isatty isatty(DOS) 

isatty ttymme(S) 

isbs ips (ADM) 

iscntrl ctype(S) 

isdigit ctypelS) 

isgraph ctype(S) 

islower ctype lS) 

ismpx ismpx(C) 

isprint ctype (S) 

ispunct ctype(S) 

isspace ctype(S) 

issue issue (F) 

isupper ctype(S) 

isverify isverify (M) 

isxdigit ctype(S) 

itoa itoa (DOS) 

jO bessel(S) 

jl bessel(S) 

jagent jagent(M) 

jn bessel(S) 

join join(C) 

jrand48 drand48(S) 

jterm jterm(C) 

jwin jwin(C) 

kbhit Icbhit (DOS) 

kbmode kbmode(ADM) 

keyboard keyboard (HW) 

kill kilKQ 

kill kill(S) 

killall killall (ADM) 

kmem mem(F) 

ksh ksh(C) 

1 /(C) 

13tol l3tol(S) 

164a a64l(S) 

labelit labelit (ADM) 

labs labs (DOS) 

langinfo langinfo(F) 

last last(C) 

lastlogin acctsh (ADM) 

layers layers (C) 

layers layers (Ml) 

Ic lc(C) 

lcong48 drand48(S) 



Id W(CP) 

Id W(M) 

Idexp frexp(S) 

Idfcn W/cn(F) 

Idfcn Idfcn (F) 

lex /ex (CP) 

Ifind lsearch(S) 

limits //mj75 (F) 

line line(C) 

linenum linenum(F) 

link link (ADM) 

link «/wfc(S) 

link_unix linkunix (ADM) 

lint lint (CP) 

list to (ADM) 

In ln(C) 

locale /oca/e (M) 

localtime ctime(S) 

lock lock(C) 

lock /ocife(S) 

lockf lockf(S) 

locking locking (S) 

log exp(S) 

log logW 

loglO exp(S) 

login login(M) 

logname logname(C) 

logname logname (S) 

logs logs(F) 

longjmp setjmp(S) 

lorder lorder(CV) 

Ip lp(C) 

Ip lp(WN) 

IpO /p(HW) 

Ipadmin lpadmin(ADM) 

Ipfilter Ipfilter (ADM) 

Ipforms Ipforms (ADM) 

Ipmove Ipsched (ADM) 

Iprint lprint(C) 

Ipsched lpsched(ADM) 

Ipsh lpsh(ADM) 

Ipshut lpsched(ADM) 

Ipstat lpstat(C) 

Ipusers Ipusers (ADM) 

lrand48 drand48(S) 

Is ls(C) 



VI 



Isearch lsearch(S) 

Iseek IseekiS) 

Itoa ltoa(DOS) 

ltol3 l3tol(S) 

m4 m4 (CP) 

machid machid(C) 

machine machine (WN) 

mail mail(C) 

maildelivery .. maildelivery (F) 
majorsinuse. majorsinuse (ADM) 

make make (CP) 

makekey makekey (ADM) 

malloc malloc(S) 

man man(C) 

mapchan mapchan(F) 

mapchan mapchan(M) 

mapkey mapkey (M) 

mapscrn mapkey (M) 

mapstr mapkey (M) 

masm masm(CP) 

math math(M) 

matherr matherr(S) 

maxuuscheds . maxuuscheds(¥) 

maxuuxqts maxuuxqts(¥) 

mconvert mconvert(M) 

mdevice mdevice(F) 

meisa meisa(F) 

mem mem(F) 

memccpy memory (S) 

memchr memory (S) 

memcmp memory (S) 

memcpy memory (S) 

memset memory (S) 

memtune memtune(F) 

mesg mesg(C) 

messages messages (M) 

mestbl mestbl(M) 

mfsys mfsys (F) 

micnet micnet(F) 

mkdev m^ev(ADM) 

mkdir mkdir(C) 

mkdir wM/-(DOS) 

mkfs mkfs(AmA) 

mknod mknod(C) 

mknod mknod(S) 

mkstr mkstr(CP) 



mktemp mktemp(S) 

mmdf mmdf(ADM) 

mmdfalias ..mmdf alias (ADM) 

mnlist mnlist(ADM) 

mnttab mnttab(F) 

modf frexp(S) 

monacct acctsh (ADM) 

monitor monitor (S) 

montbl montbl(M) 

more more(C) 

mount mount (ADM) 

mount mount(S) 

mountall mountall(ADM) 

mouse mouse (liW) 

movedata movedata (DOS) 

mrand48 drand48(S) 

mscreen mscreen(M) 

msgctl msgctl (S) 

msgget msgget(S) 

msgop msgop(S) 

mtune mtune(F) 

multiscreen .... multiscreen (M) 

mv mv(C) 

mvdir mvdir(ADM) 

nap nap(S) 

nbwaitsem waitsem(S) 

ncheck ncheck (ADM) 

netutil netutil (ADM) 

newform newform(C) 

newgrp newgrp(C) 

news ^^^^(C) 

nextkey dbm(S) 

nice nice(C) 

nice ., nice(S) 

nictable nictable (ADM) 

nl nl(C) 

nlist nlist(S) 

nlsadmin nlsadmin(ADM) 

nl_type nl_type(F) 

nm nm(CP) 

nohup nohup(C) 

nrand48 drand48(S) 

null null(F) 

nuUadm acctsh (ADM) 

numtbl numtblQA) 

od od(C) 
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open open(S) 

opendir directory (S) 

opensem opensem(S) 

otar otar(C) 

outp outp (DOS) 

pack pack(C) 

parallel parallel (HW) 

passwd passwd(C) 

passwd passwd(F) 

paste paste (C) 

pause pause(S) 

pax pax(C) 

peat packiC) 

pclose popen(S) 

pcpio pcpio(C) 

pcu pcu(ADM) 

permissions permissions (F) 

perror perror(S) 

Pg Pg(C) 

pipe pipe(S) 

plock plock(S) 

plot ploi(F) 

pnch pnch(¥) 

poll poll(¥) 

popen popen(S) 

pow exp(S) 

powerfail powerfail(M) 

pr pr(C) 

prctmp acctsh(ADM) 

prdaily acctsh (ADM) 

prf prf(BW) 

prfdc profiler (ADM) 

prfld profiler (ADM) 

prfpr profiler(ADM) 

prfsnap profiler (ADM) 

prfstat profiler(ADM) 

printf printf(S) 

proctl proctl(S) 

prof.... prof (CP) 

profil profit (S) 

profile profile (M) 

profiler profiler(ADM) 

promain promain(M) 

proto proto (ADM) 

prs prs (CP) 

prtacct acctsh (ADM) 



PS ps(C) 

pscat pscat(C) 

pstat pstat(C) 

ptrace ptrace(S) 

purge purge (C) 

purge purge (F) 

putc putc(S) 

putch /?Mrc/t (DOS) 

putchar putc(S) 

putenv putenv(S) 

putpwent putpwent(S) 

puts puts(S) 

pututline getut(S) 

putw putc(S) 

p wcheck pwcheck (C) 

pwd pwd(C) 

qsort qsort(S) 

queue queued?) 

queuedefs queuedefs(F) 

quot quot(C) 

ramdisk ramdisk(V[W) 

rand rand(S) 

random random(C) 

ranlib ranlib(CP) 

ratfor ratfor(CP) 

rcO rcO(ADM) 

rc2 rc2 (ADM) 

rep rcp(C) 

revtrip rcvtrip (C) 

rdchk rdchk(S) 

read read(S) 

readdir directory (S) 

realloc malloc(S) 

reboot haltsys (ADM) 

red ed(C) 

reduee reduce (ADM) 

regemp regcmp (CP) 

regemp regex(S>) 

regex regex(S,) 

regexp regexp(S) 

rejeet accept (ADM) 

reloe reloc(¥) 

relogin relogin(ADM) 

remote remote (C) 

removepkg . removepkg(ADM) 
rename rename (DOS) 
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restart restart(M) 

restore restore (ADM) 

rewind fseek(S) 

rewinddir directory (S) 

rm rm(C) 

rmail mw2/7(ADM) 

rmb rmb(M) 

rmdel rmdel(CP) 

rmdir rm(C) 

rmdir rmdir(DOS) 

routines routines (ADM) 

rsh rsh(C) 

rtc r/c (HW) 

runacct acctsh (ADM) 

runacct runacct (ADM) 

sal ^ar(ADM) 

sa2 sar(ADM) 

sact ^acr (CP) 

sadc sar(ADM) 

sag sag(ADM) 

sar sar(ADM) 

sbrk sbrk(S) 

scanf scanf(S) 

sccsdiff sccsdiff(CP) 

sccsfile sccsfile(F) 

schedule schedule (ADM) 

scnhdr scnhdr(F) 

scr_dump scr_dump(F) 

screen screen(HW) 

scsi scsillTW) 

scsinfo scsinfo (ADM) 

sdb sdb(CP) 

sddate sddate(C) 

sdenter sdenter(S) 

sdevice sdevice (F) 

sdfree sdget(S) 

sdget sdget(S) 

sdgetv sdgetv(S) 

sdiff sdiff(C) 

sdleave sdenter (S) 

sdwaitv sdgetv (S) 

sed sed(C) 

seed48 drand48(S) 

seekdir directory (S) 

segread segread(DOS) 

select select (S) 



semctl semctl (S) 

semget semget(S) 

semop semap (S) 

send send(ADM) 

serial serial (HW) 

setbuf setbuf(S) 

setclock setclock (ADM) 

setcolor setcolor(C) 

setgid setuid(S) 

setgrent getgrent(S) 

setjmp setjrrq)(S) 

setkey setkey(C) 

setlocale setlocale(S) 

setmnt setmnt (ADM) 

setmode setmode(C) 

setmode setmode (DOS) 

setpgrp setpgrp(S) 

setpwent getpwent(S) 

settime settime (ADM) 

setuid setuid(S) 

setutent getut(S) 

setvbuf setbuf (S) 

sfsys sfsys (F) 

sgetl sputl(S) 

sh sh(C) 

shl shl(C) 

shmctl shmctl(S) 

shmget shmget(S) 

shmop shmop(S) 

shutacct acctsh (ADM) 

shutdn shutdn(S) 

shutdown shutdown(ADM) 

signal signal (S) 

sigsem sigsem(S) 

sin trig(S) 

sinh sinh(S) 

size size (CP) 

sleep sleep (C) 

sleep sleep (S) 

sopen sopen(DOS) 

sort sort(C) 

spawnl spawn(DOS) 

spawnvp spawn(DOS) 

spell spell (C) 

spellin spell (C) 

spline spline (C) 



split split (C) 

sprintf printfiS) 

sputl sputllS) 

sqrt explS) 

srand48 randls) 

sscanf scanflS) 

ssignal ssignalls) 

startup acctsh(ADM) 

Stat stat(F) 

Stat stat{S) 

statfs statfslS) 

stdio stdio(S) 

stime stimels) 

store dbm(S) 

strace strace (ADM) 

strcat string (S) 

strchr stringls) 

strclean strclean (ADM) 

strcmp string (S) 

strcpy string (S) 

strcspn string (S) 

strdup string (S) 

strerr strerr(ADM) 

streamio streamio(M) 

strftime strftime(S) 

string string (S) 

strings strings (C) 

strip strip(CP) 

strlen strlen(DOS) 

strlwr strlwr(DOS) 

strmcfg strmcfg (ADM) 

strmtune strmtune(ADM) 

strncat string (S) 

strncmp string (S) 

strncpy string (S) 

strpbrk string (S) 

strrchr string (S) 

strrev strrev (DOS) 

strset strset (DOS) 

strspn string (S) 

strtod strtod(S) 

strtok string (S) 

strtol strtol(S) 

strupr strupr(DOS) 

stty stty(C) 

stune stune (F) 



su su(C) 

submit submit (ADM) 

subsystem subsystem(M) 

sulogin sulogin(ADM) 

sum sum(C) 

swab swab(S) 

swap swap (ADM) 

swconfig swconfig(C) 

sxt sxt(M) 

syms synis(F) 

sync sync (ADM) 

sync sync(S) 

sys_errlist perror(S) 

sys_nerr perror(S) 

sysadmsh sysadmsh(ADM) 

sysdef sysdef(ADM) 

sysfiles sysfiles(F) 

sysi86 sysi86(S) 

system system(S) 

systemid systemid(F) 

systems systems (F) 

systty systty(M) 

tables tables (F) 

tabs tabs(C) 

tail tail(C) 

tam tam(S) 

tan trig(S) 

tanh .sinh(S) 

tape tape(Q) 

tape tape(WN) 

tapecntl tapecntl (C) 

tapedump tapedump(C) 

tar tar(C) 

tar tar(F) 

tcbck tcbck (ADM) 

tdelete tsearch(S) 

tee tee (C) 

tell tell (DOS) 

telldir directory (S) 

tempnam tmpnam(S) 

term term(F) 

termcap termcap(F) 

terminal terminal (HW) 

terminals terminals (M) 

"terminfo" "terminfo"(F) 

"terminfo" "terminfo" (M) 
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"terminfo" "terminfo"(S) 

termio termio (M) 

termios termios(M) 

test test(C) 

tfind tsearch (S) 

tgetent tenncap(S) 

tgetflag termcap(S) 

tgetnum termcap(S) 

tgetstr termcapiS) 

tgoto termcapiS) 

tic tic(C) 

time time(C) 

time time(S) 

times times (S) 

timex timex(ADM) 

timezone timezone (F) 

timod timod(M) 

tirdwr tirdwr(M) 

tmpfile tmpfileiS) 

tmpnam tmpnam(S) 

toascii conv(S) 

toascii ctype(S) 

tolower conv(S) 

tolower ctype{S) 

top top(F) 

top.next top(¥) 

touch touch (C) 

toupper conv(S) 

toupper ctype(S) 

tplot tplot(ADM) 

tput tput(C) 

tputs termcap(S) 

tr tr(C) 

translate translate (C) 

trchan trchan(M) 

true true(C) 

tsearch tsearch (S) 

tset tset(C) 

tsort tsort(CP) 

tty ttyiC) 

tty ttyiU) 

ttyname ttyname (S) 

tty slot ttyslotiS) 

turnacct acctsh (ADM) 

twalk tsearch (S) 

types types (F) 



TZ /z(M) 

tzset ctime (S) 

uadmin uadmin(S) 

uconfig uconfig(ADM) 

ulimit ulimit(S) 

ultoa ultoa(DOS) 

umask umask(C) 

umask umask(S) 

umount umount(ADM) 

umount umount(S) 

umountall mountalI(ADM) 

uname uname(C) 

uname uname(S) 

uncompress compress (C) 

unget unget(CP) 

ungetc ungetc(S) 

ungetch ungetch (DOS) 

uniq uniq{C) 

unistd unistd(F) 

units units (C) 

unlink link (ADM) 

unlink unlink (S) 

unpack pack(C) 

upcfg upscfg(S) 

upsconfig upsconfig(ADM) 

uptime uptime (C) 

usemouse usemouse(C) 

ustat ustat(S) 

utime utime(S) 

utmp utmp(¥) 

utmpname getut(S) 

uuchat dial (ADM) 

uucheck uucheck (ADM) 

uucico uucico (ADM) 

unclean uuclean (ADM) 

uucp uucp(C) 

uuencode uuencode(C) 

uugetty uugetty (ADM) 

uuinstall uuinstall (ADM) 

uulist MM to (ADM) 

uulog uucp(C) 

uuname uucp(C) 

uupick uuto(C) 

uusched uusched(ADM^) 

uustat uustat(C) 

uuto uuto(C) 



uutry uutry(ADM) 

uux uwc(C) 

uuxqt uuxqt (ADM) 

val va/(CP) 

values values (M) 

varargs varargs(S) 

vc vc(C) 

vddaemon ... vddaemon(ADM) 

vdinfo vdinfo (ADM) 

vdutil vdutil (ADM) 

vectorsinuse. vectorsinuse (ADM) 

vedit vj (C) 

vfprintf vprintf(S) 

vi vi(C) 

vidi vidi(C) 

view VI (C) 

vmstat vmstat(C) 

volcopy volcopy (ADM) 

vprintf vprintf(S) 

vsprintf vprintf (S) 

w w(C) 

wait wait(C) 

wait wait(S) 

waitsem waitsem(S) 

wall wall(ADM) 

wc wc(C) 

what what(C) 

who who(C) 

whodo whodo(C) 

write write (C) 

write write (S) 

wtinit wtinit (ADM) 

wtmp utmp(F) 

wtmpfix fwtmp(ADiA) 

x286emul x286emul(C) 

xargs xargs(C) 

xbackup xbackup (ADM) 

xbackup xbackup (F) 

xinstall xinstall (ADM) 

xlist xlist(S) 

xprcat .....xprcat(C) 

xprsetup xprsetup (ADM) 

xprtab xprtab(F) 

xref xref (CP) 

xrestore xrestore (ADM) 

xstr xstr(CP) 



xt xt(}m) 

xtod xtod(C) 

xtproto xtproto(M) 

xts xts (ADM) 

xtt xtt (ADM) 

yO bessel(S) 

yl bessel(S) 

yacc yacc(CP) 

yes yes(C) 

yn bessel(S) 

zcat compress (C) 
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Intro 

introduction to system administration commands 
Description 

This section contains the commands that are used to administrate and 
maintain the operating system. These commands are largely root- 
only, meaning that they can only be executed by the super-user (root). 
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accept, reject 

allows/prevents print requests to a lineprinter or class 
of printers 

Syntax 



Aisr/lib/accept destinations 
/usr/lib/reject [ -r[ reason ] ] destinations 

Description 



accept allows lp(C) to accept requests for the named destinations . A 
destination can be either a printer or a class of printers. Use lpstat{C) 
to find the status of destinations . 

reject prevents lp(C) from accepting requests for the named destina- 
tions. A destination can be either a printer or a class of printers. Use 
lpstat(C) to find the status of destinations . The following option is 
useful with reject : 

-r[ reason] Associates a reason with disabling (using disable (C)) 
the printer. The rga^on applies to ^1 printers listed up to 
the next -r option. If the -r option is not present or the -r 
option is given without a reason, then a default reason is 
used. Reason is reported by Ipstat(C). Please see 
disable(C) for an example of reason syntax. 

Files 



/usr/spoolAp/* 

See Also 



enable(C), lp(C), Ipadmin(ADM), Ipsched(ADM), Ipstat(C), 
disable(C) 
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acct: acctdisk, acctdusg, accton, 
acctwtmp 

overview of accounting and miscellaneous accounting 
commands 

Syntax 



/usr/lib/acct/acctdisk 
/usr/lib/acct/acctdusg [ -u file ] [ -p file ] 
/usr/lib/acct/accton [ file ] 
/usr/lib/acct/acctwtmp "reason" 

Description 



Accounting software is structured as a set of tools (consisting of both 
C programs and shell procedures) that can be used to build accounting 
systems. When the system is installed, accounting is initially in the 
"off" state, acctsh (ADM) describes the set of shell procedures built 
on top of the C programs. 

Connect time accounting is handled by various programs that write 
records into /etc/utmp, as described in utmp(F). The programs 
described in acctcon^KDM) convert this file into session and charging 
records, which are then summarized by acctmerg (ADM). 

Process accounting is performed by the UNIX system kernel. Upon 
termination of a process, one record per process is written to a file 
(normally /usr/adm/pacct). The programs in acctprc{PjyM) summar- 
ize this data for charging purposes; acctcms (ADM) is used to summar- 
ize command usage. Current process data may be examined using 
acctcom (C). 

Process accounting and connect time accounting [or any accounting 
records in the format described in acct(F)] can be merged and sum- 
marized into total accounting records by acctmerg [see tacct format 
in acct(P)]. prtacct [see acctsh {kT>M)] is used to format any or all 
accounting records. 

acctdisk reads lines that contain user ID, login name, and number of 
disk blocks and converts them to total accounting records that can be 
merged with other accounting records. 



March 19, 1990 



ACCT-1 



ACCT (ADM) 



ACCT(ADM) 



acctdusg reads its standard input (usually from find / -print) and com- 
putes disk resource consumption (including indirect blocks) by login. 
If -u is given, records consisting of those file names for which 
acctdusg charges no one are placed in file (a potential source for Hnd- 
ing users trying to avoid disk charges). If -p is given, file is the name 
of the password file. This option is not needed if the password file is 
/etc/passwd. [See diskusg(ADM) for more details.] 

accton alone turns process accounting off. If file is given, it must be 
the name of an existing file to which tiie kernel appends process 
accounting records [see acct{S) and accf (F)]. 

acctwtmp writes a utmp(P) record to its standard output. The record 
contains the current time and a string of characters diat describe the 
reason. A record type of ACCOUNTING is assigned [see utmp(F)]. 
Reason must be a string of 11 or fewer characters, numbers, $, or 
spaces. For example, the following are suggestions for use in reboot 
and shutdown procedures, respectively: 

acctwtmp uname »/etc/wtmp 
acctwtmp "file save" »/etc/wtmp 

Files 



/etc/passwd used for login name to user ID conversions 

/usr4ib/acct holds all accounting commands listed in this manual 

/usr/adm/pacct current process accounting file 

/etc/wtmp login/logoff history file 

See Also 



acctcms(ADM), acctcom(C), acctcon(ADM), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), diskusg(ADM), fwtmp(ADM), 
runacct(ADM), acct(S), acct(F), utmp(F) 

Standards Conformance 



acctdisk is conformant with: 

AT&T SVK) Issue 2, Select Code 307-127. 

Value Added 



accton is an extension to AT&T System V provided in Altos UNIX 
System V. 
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ACCTCMS (ADM) 



command summary from per-process accounting 
records 

Syntax ' 



/usr/Iib/acct/acctcms [options] files 

Description 



acctcms reads one or more files, normally in the form described in 
acct(F). It adds all records for processes that executed identically- 
named commands, sorts them, and writes them to the standard output, 
normally using an intemal summary format. The options are: 

-a Print output in ASCII rather than in the intemal summary format. 
The output includes command name, number of times executed, 
total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, **hog factor", char- 
acters transferred, and blocks read and written, as in acctcom(C). 
Output is normally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under "***other". 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are akeady in intemal sum- 
mary format. 

-t Process all records as total accounting records. The default inter- 
nal summary format splits each field into prime and non-prime 
time parts. This option combines the prime and non-prime time 
parts into a single field that is the total of both, and provides 
upward compatibility with old (i.e., UNIX System V) style 
acctcms intemal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Ou^ut a non-prime (ofiFshift) time only command summary. 

When -p and -o are used together, a combination prime and non-prime 
time report is produced. All the output summaries will be total usage 
except number of times executed, CPU minutes, and real minutes 
which will be split into prime and non-prime. 

A typical sequence for performing daily command accounting and for 
maintaining a running total is: 
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acctcms file . . . >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms -a -s today 

See Also 



acct(ADM), acctcom(C), acctcon(ADM), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), ninacct(ADM), acct(S), 
acct(F), utmp(F) 

Notes 



Unpredictable output results if -t is used on new style internal sum- 
mary format files, or if it is not used with old style internal summary 
format files. 

Standards Conformance 



acctcms is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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acctcom 

search and print process accounting file(s) 

Syntax 

acctcom [ [ options ] [ file ] ] . . . 

Description 

acctcom reads file , the standard input, or /usr/adm/pacct, in the form 
described by acct(F) and writes selected records to the standard out- 
put. Each record represents the execution of one process. The output 
shows the COMMAND Name, USER, TTYName, START TIME, END 
TIME, REAL (SEC), CPU (SEC), MEAN SIZE(K), and optionally, F 
(the fork/exec flag: 1 for fork without exec), STAT (the system exit 
status), HOG FACTOR, KCORE MIN, CPU FACTOR, CHARS 
TRNSFD, and BLOCKS READ (total blocks read and written). 



The command name is prepended with a # if it was executed with 
super-user privileges. If a process is not associated with a known ter- 
minal, a ? is printed in the TTYName field. 

If no files are specified, and if the standard input is associated with a 
terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read; otherwise, the standard input is read. 

If any file arguments are given, they are read in their respective order. 
Each file is normally read forward, i.e., in chronological order by pro- 
cess completion time. The file /usr/adm/pacct is usually the current 
file to be examined; a busy system may need several such files of 
which all but the current file are found in /usr/adm/pacct.^. The 
options are: 

-a Show some average statistics about the processes 

selected. The statistics will be printed after the output 
records. 

-b Read backwards, showing latest commands first. This 

option has no effect when the standard input is read. 

-f PYint the fork/exec flag and system exit status columns 

in the output. 

-h Instead of mean memory size, show the fraction of total 

available CPU time consumed by the process during its 
execution. This "hog factor" is computed as: 
(total CPU time)/(elapsed time). 

-i Print columns containing the I/O counts in the output. 
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-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/(system-time + user-time). 

-t Show separate system and user CPU times. 

-V Exclude column headings from the output. 

-I line Show only processes belonging to terminal /de\/line . 

-u user Show only processes belonging to user that may be 
specified by: a user ID, a login name that is then con- 
verted to a user ID, a # which designates only those pro- 
cesses executed with super-user privileges, or ? which 
designates only those processes associated with 
unknown user IDs. 

-g group Show only processes belonging to group. The group 
may be designated by either the group ID or group 
name. 

-s time Select processes existing at or after time , given in the 

format hr [ :min [:sec]]. 
-e time Select processes existing at or before time . 

-S time Select processes starting at or after time . 
-E time Select processes ending at or before time . Using the 

same time for both -S and -E shows the processes that 

existed at time . 

-n pattern Show only commands matching pattern that may be a 

regular expression as in ed(C) except that + means one 

or more occurrences, 
-q Do not print any output records; just print the average 

statistics as with the -a option, 
-o ofile Copy selected process records in the input data format 

to ofile ; suppress standard output printing. 
-H factor Show only processes that exceed /acfor, where factor is 

the "hog factor" as explained in option -h above. 
-O sec Show only processes with CPU system time exceeding 

sec seconds. 

-C sec Show only processes with total CPU time, system plus 

user, exceeding sec seconds. 
-I chars Show only processes transferring more characters than 

the cut-off number given by chars. 



Files 



/etc/passwd 

/usr/adm/pacct 

/etc/group 



See Also 



acct(ADM), acctcms(ADM), acctcon(ADM), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), ps(C), runacct(ADM), 
su(ADM), acct(S), acct(F), utmp(F). 
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Notes 



acctcom reports only on processes that have terminated; use ps(C) for 
active processes. If time exceeds the present time, then time is inter- 
preted as occurring on the previous day. 
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acctcon: acctconi, acctcon2 



connect-time accounting 
Syntax 



/usr/Iib/acct/acctconl [options] 
/usr/lib/acct/acctcon2 

Description 



acctconi converts a sequence of login/logoff records read from its 
standard input to a sequence of records, one per login session. Its 
input should normally be redirected from /etc/wtmp. Its output is 
ASCII, giving device, user ID, login name, prime connect time 
(seconds), non-prime connect time (seconds), session starting time 
(numeric), and starting date and time. The options are: 

-p Print input only, showing line name, login name, and time (in 
both numeric and date/time formats). 

-t acctconi maintains a list of lines on which users are logged in. 
When it reaches the end of its input, it emits a session record 
for each line that still appears to be active. It normally 
assumes that its input is a current file, so that it uses the current 
time as the ending time for each session still in progress. The 
-t flag causes it to use, instead, the last time found in its input, 
thus assuring reasonable and repeatable numbers for non- 
current files. 

-I file File is created to contain a summary of line usage showing 
line name, number of minutes used, percentage of total elapsed 
time used, number of sessions charged, number of logins, and 
number of logoffs. This file helps track line usage, identify bad 
lines, and find software and hardware oddities. Hang-up, ter- 
mination of login(M) and termination of the login shell each 
generate logoff records, so that the number of logoffs is often 
three to four times the number of sessions. See init(M) and 
utmp(F). 

-o file File is filled with an overall record for the accounting period, 
giving starting time, ending time, number of reboots, and num- 
ber of date changes. 

acctcoriZ expects as input a sequence of login session records and 
converts them into total accounting records [see tacct format in 
acctCF)]. 
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ACCTCON (ADM) 



These commands are typically used as shown below. The file ctmp is 
created only for the use of acctprc (ADM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp | sort +ln +2 >ctmp 
acctcon2 <ctmp | acctmerg >ctacct 

Files 



/etc/wtmp 

See Also 



acct(ADM), acctcms(ADM), acctcom(C), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), init(M), runacct(ADM), 
acct(S), acct(F), utmp(F) 

Notes 



The line usage report is confused by date changes. Use wtmpfix [see 
fwtmp(ADM)] to correct this situation. 

Standards Conformance 



acctconl and acctconl are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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acctmerg 



merge or add total accounting files 
Syntax 



/usr/Iib/acct/acctmerg [options] [file] . . . 

Description 



acctmerg reads its st^dard input and up to nine additional files, all in 
the tacct format [see acct(F)] or an ASCII version thereof. It merges 
these inputs by adding records whose keys (normally user ID and 
name) are identical, and expects the inputs to be sorted on those keys. 
Options are: 

-a Produce output in ASCII version of tacct. 
-i Input files are in ASCII version of tacct. 
-p Print input with no processing, 
-t I*roduce a single record that totals all input, 
-u Summarize by user ID, rather than user ID and name. 
-V Produce output in verbose ASCII format, with more precise nota- 
tion for floating point numbers. 

Examples 



The following sequence is useful for making "repairs" to any file kept 
in this format: 

acctmerg -v <filel >file2 

edit file! as desired . . . 
acctmerg -i <file2 >filel 

See Also 



acct(ADM), acctcms(ADM), acctcom(C), acctcon(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), runacct(ADM), acct(S), 
acct(F), utmp(F) 

Standards Conformance 



acctmerg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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accton 

turns on accounting 

Syntax 

accton [file] 

Description 

accton turns on and off process accounting. If no file is given then 
accounting is turned off. If file is given, tilie kernel appends process 
accounting records. (See acct (S) and acct (F)), 

Fiies 

/etc/passwd 
/usr/adm/pacct 
/usr/adm/sulogin 
/etc/wtmp 

See Aiso 

acctcom(ADM), acct(S), acct(F), su(C), utmp(F) 

Value Added 

accton is an extension to AT&T System V developed in Altos UNIX 
System V. 



Used for logm name to user ID conversions 
Current process accounting file 
Super-user login history file 
Login/logout history file 
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acctprc: acctprd, acctprc2 



process accounting 
Syntax 



/usr/lib/acct/acctprcl [ctmp] 
/usr/lib/ acct/acctprc2 

Description 



acctprd reads input in the form described by acct(F), adds login 
names corresponding to user IDs, then writes for each process an 
ASCII line giving user ID, login name, prime CPU time (tics), non- 
prime CPU time (tics), and mean memory size (in memory segment 
units). If ctmp is given, it is expected to contain a list of login ses- 
sions, in the form described in acc/con (ADM), sorted by user ID and 
login name. If this file is not supplied, it obtains login names from the 
password file. The information in ctmp helps it distinguish among 
different login names that share the same user ID. 

acctprd reads records in the form written by acctprd , summarizes 
them by user ID and name, then writes the sorted summaries to the 
standard output as total accounting records. 

These commands are typically used as shown below: 

acctprd ctmp </usr/adm/pacct | acctprc2 >ptacct 

Fiies 



/etc/passwd 

See Also 



acct(ADM), acctcms(ADM), acctcom(C) acctcon(ADM), 
acctmerg(ADM), acctsh(ADM), cron(C), fwtmp(ADM), 
runacct(ADM), acct(S), acct(F), utmp(F) 
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ACCTPRC (ADM) 



Although it is possible to distinguish among login names that share 
user IDs for commands run normally, it is difficult to do this for those 
commands run from croniC), for example. More precise conversion 
can be done by faking login sessions on the console via the acctwtmp 
program in acct (ADM). 

Standards Conformance 



acctprcl and acctprc2 are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 



March 15, 1989 



ACCTPRC-2 



ACCTSH (ADM) 



ACCTSH (ADM) 



acctsh: chargefee, ckpacct, dodisk, 
lastiogin, monacct, nulladm, prctmp, 
prdaily, prtacct, runacct, shutacct, 
startup, turnacct 

shell procedures for accounting 

Syntax 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 
/usr/lib/acct/dodisk [-o] [files ...] 
/usr/lib/acct/Iastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/ acct/prctmp 
/usrAib/acct/prdaily [-1] [-c] [ mmdd ] 
/usr/lib/acct/prtacct file [ "heading" ] 
/usr/lib/acct/runacct [mmdd] [mmdd state] 
/usr/lib/acct/shutacct [ "reason" ] 
/usr/lib/acct/startup 
/usr/lib/acct/turnacct on | off | switch 

Description 

chargefee can be invoked to charge a number of units to login-name . 
A record is written to /usr/adm/fee to be merged with other account- 
ing records during the night. 

ckpacct should be initiated via cron(C). It periodically checks the 
size of /usr/adm/pacct. If the size exceeds blocks, lOOO by default, 
turnacct will be invoked with argument switch. If ihc number of free 
disk blocks in the /usr file system falls below 500, ckpacct will auto- 
matically turn off the collection of process accounting records via the 
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ojf argument to turnacct. When at least this number of blocks is 
restored, the accounting will be activated again. This feature is sensi- 
tive to the frequency at which ckpacct is executed, usually by cron. 

dodisk should be invoked by cron to perform the disk accounting 
functions. By default, it will do disk accounting on the special files in 
/etc/default/fllesys . If the -o flag is used, it will do a slower version of 
disk accounting by login directory. Files specify the one or more 
filesystem names where disk accounting will be done. If files are 
used, disk accounting will be done on these file systems only. If the -o 
flag is used, files should be mount points of mounted filesystem. If 
omitted, they should be the special file names of mountable file sys- 
tems. 

lastlogin is invoked by runacct to update /usr/adm/acct/sum/Iog- 
inlog, which shows the last date on which each person logged in. 

monacct should be invoked once each month or each accounting peri- 
od. Number indicates which month or period it is. If number is not 
given, it defaults to the current month (01-12). This default is useful if 
monacct is to executed via cron(C) on the first day of each month. 
monacct creates summary files in /usr/adm/acct/fiscal and restarts 
summary files in /usr/adm/acct/sum. 

nulladm creates file with mode 664 and ensures that owner and group 
are adm. It is called by various accounting shell procedures. 

prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acc/con (ADM). 

prdaily is invoked by runacct to format a report of the previous day's 
accounting data. The report resides in /usr/adm/acct/sum/rprtmwf/i/ 
where nvndd is the month and day of the report. The current daily 
accounting reports may be printed by typing prdaily. Previous days' 
accounting reports can be printed by using the mmdd option and speci- 
fying the exact report date desired. The -1 flag prints a report of 
exceptional usage by login id for the specified date. Previous daily 
reports are cleaned up and therefore inaccessible after each invocation 
of monacct. The -c flag prints a report of exceptional resource usage 
by command, and may be used on current day's accounting data only. 

prtacct can be used to format and print any total accounting (tacct) 
file. 

runacct performs the accumulation of connect, process, fee, and disk 
accounting on a daily basis. It also creates summaries of command 
usage. For more information, see runacct(ADM). 

shutacct is invoked during a system shutdown to turn process account- 
ing off and append a "reason" record to /etc/wtmp. 
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startup is called by /etc/initd/acct to turn the accounting on when- 
ever the system is brought to a multiuser state. 

turmcct is an interface to accton [see acrt(ADM)] to turn process 
accounting on or off. The switch argument turns accounting off, 
moves the current /usr/adm/pacct to the next free name in 
/usr/adm/pacct/ncr (where incr is a number starting with 1 and incre- 
menting by one for each additional pacct file), then turns accounting 
back on again. This procedure is called by ckpacct and thus can be 
taken care of by the cron and used to keep pacct to a reasonable size. 
acct starts and stops process accounting via imt and shutdown accord- 
ingly. 



Files 



/usr/adm/fee 

/usr/adm/pacct 

/usr/adm/pacct* 

/etc/wtmp 

/usr/lib/acct/ptelus.awk 

/usr/lib/acct/ptecms.awk 

/usr/adm/acct/nite 
/usr/lib/acct 

/usr/adm/acct/sum 



accumulator for fees 

current file for per-process accounting 

used if pacct gets large and during execution 

of daily accounting procedure 

login/logoflf summary 

contains the limits for exceptional usage by 
login id 

contains the limits for exceptional usage by 
command name 
working directory 

holds all accounting commands listed in 
(ADM) 

summary directory, should be saved 



See Also 



acct(ADM), acctcms(ADM), acctcom(ADM), acctcon(ADM), 
acctmerg(ADM), acctprc(ADM), cron(C), diskusg(ADM), 
fwtmp(ADM), runacct(ADM), acct(S), acct(F), utmp(F) 



Standards Conformance 



chargefee is conformant with: 

ANSI X3.159-198X C Language Draft Standard, May 13, 1988. 

ckpacct, lastlogin, prctmp, runacct and shutacct are conformant with; 
AT&TSVID Issue 2, Select Code 307-127. 
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add.vd 

add a virtual disk 
Syntax 



add.vd [-d] [n] 

Description 



The add.vd utility is not intended for direct use by system users. It is 
invoked by vdutil(ADM). add.vd installs a virtual disk (for building a 
striped or mirrored filesystem across several disk divisions or physical 
disks). The system must be in singleuser mode to use this command. 
You must have already run mkdev hd to add all the physical hard disks 
on the system before using add.vd. (See "Adding Hard Disks" in the 
System Administrator's Guide.) 

If n is not specified on the command line, the script prompts you for 
the virtual disk number. Once you reply with a correct number, the 
system installs the designated virtual disk. 

Several questions are asked interactively to identify the physical disk 
divisions to be used and the mount point. 

To efficiently use the available disk space, all disk divisions that 
comprise the virtual disk should be the same size. 



Options 



-d Non-destructive mode. The device special files are created, but 
no new filesystem is built. 



n Add virtual disk number n. 

See Aiso 



del.vd(ADM, vdinfo(ADM), vddaemon(ADM) vdutil(ADM) 

Note 

Also refer to "Virtual Disks" in the System Administrator's Guide. 
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Value Added 

add.vd is an extension of AT&T System V provided in Altos UNIX 
System V. 
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addxusers 



create new user accounts given a XENIX-style pass- 
word file 

Syntax 



/tcb/bin/addxusers [ -e ] [ -s ] [ -t type ] [ file ] 

Description 



addxusers reads the specified file, which should be in XENIX 
passwd(F) format, and creates the indicated accounts by making 
equivalent entries in the system's /etc/passwd file and Protected Pass- 
word database. The auth subsystem and chown kernel authorizations 
are required to run addxusers. If no file is given, addxusers does not 
attempt to add any new users and only performs certain consistency 
checks on the existing user accounts. A file of - means that the stan- 
dard input should be read. 

Login names must begin with a lower case letter, must not already 
exist, must not contain a slash (*7"), and must not be longer than 8 
characters. 

Numeric user IDs must not be already assigned, and must be in the 
range 0 to 60000 (inclusive). 

Numeric group IDs must be in the range 0 to 60000 (inclusive). 
Groups which are missing from the file /etc/group are warned about, 
as is membership in a group associated with a protected subsystem. 

Encrypted passwords are preserved; that is, users will be able to use 
their old XENIX passwords to log onto the new system. 

Any password aging information which is present is translated into the 
equivalent expiration parameters. 

The comment field, initial working directory (home directory), and 
shell program are preserved. Missing or inaccessible directories and 
shells are warned about, as are non-absolute pathnames. Users should 
not share home directories. 



March 19, 1990 



ADDXUSERS-1 



ADDXUSERS(ADM) 



ADDXUSERS (ADM) 



The -t option sets the type of each created user; if omitted, each user is 
classified as an "individual' ' person. The legal type values are: 



Number 


User type values 

Equivalent names 


Comments 


0 


root 


superuser 


All-powertul user (nimieric ID 0). 


1 


operator 




Various classifications of 
anonymous system administration 
accounts. 


2 


sso 


security officer 


3 


admin 


administrator 


4 


pseudo 


pseudo-user 


General-purpose anonymous user. 


5 


general 


individual 


A human's personal account. 


6 


retired 




An account which is no longer used. 



A "retired' ' user cannot log in and cannot be un-retired. No user may 
^^(C) to an "individual' ' account. 



Normally, only minimal checks for corruption are done on the existing 
/etc/passwd file before the new users are added: Checks are only 
done for duplicated login names or numeric user IDs, and bad format. 
(These are all fatal errors, and prevent any new users from being 
added.) The -e option causes the same checks which are applied to 
new users to be applied to the existing users (except for membership 
in a protected subsystem group). The -s option checks the existing 
users for being a member of a protected subsystem group. As widi 
new user accounts, not all of the problems which may be discovered 
are fatal (many are only warnings). 

Duplicated group names or numeric group IDs in the /etc/group file 
are warned about. However, if a protecte-d subsystem group is so cor- 
rupted, this is a fatal error (no users are added). 

Example 



The following steps should be performed when migrating a commun- 
ity of users from a XENIX system: 

1. Back up the home directories of the users on the XENIX system 
using cpio(C) or tar(C). 

2. Make a copy of /etc/passwd and /etc/group from the XENIX sys- 
tem. (Do not back up these files using absolute pathnames. For 
example, if your accounts are in /usr, run your backup command 
from that directory, not from /.) 

3. After making certain you are in single user mode, extract ti e 
backup of the user's home directories on the new system. For 
example, if your user accounts reside in /usr, the files should be 
extracted in /usr on the new system. (Note that if you are using /u 
for your accounts, you must mount it before extracting your back- 
ups.) 
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4. Extract the copy of the passwd and group files in a temporary 
directory; for example, /tmp/passwd and /tmp/group. Be careful 
not to overwrite the /etc/passwd and /etc/group files on the new 
system. 

5. Edit /tmp/passwd to remove "system" accounts (such as root and 
bin) and any accounts that already exist on the new system. 

6. Separate the remaining accounts in /tmp/passwd (which are to be 
added to the new system) into different files by user type. For 
example, place all "pseudo-users" in a file called /tmp/pseudo 
and all "individual" humans in /tmp/individual. 

7. In your sorted /tmp account files, you should then change login 
names, numeric user IDs, numeric group IDs, initial working direc- 
tories, and shell programs as necessary to prevent conflicts with 
any accounts already on the new system. (If any numeric user or 
group IDs are changed, it may be desirable to chown(C) or 
chgrpiC) the appropriate home directories on the new system and 
their contents.) 

8. Merjge /tmp/group (the saved copy of the XENIX system's 
/etc^roup) with the new system's /etc/group; see group {¥). 
Again, make certain you are still in single-user mode; if /etc/group 
is modified while in multi-user mode, no-one will be allowed to 
log in. 

9. Run addxusers : 

addxusers -t pseudo-user /tmp/pseudo 2>&1 I tee -a /tmp/errors 
addxusers -t individual /tmp/individual 2>&1 I tee -a /tmp/errors 

It is advisable to save the standard output and error output of 
addxusers (as shown above) for later analysis and correction. 

Finally, use the Accounts^User-^Examine menu of 
sysadmsh(ADM) to customize the newly-created accounts as needed. 

The authorizations may need customization, and accounts which are 
neither individuals nor retired should have an "account which may 
su" assigned. 

See Also 



authcap(F), chgrp(C), chown(C), cpio(C), group(F), passwd(F), su(C), 
sysadmsh(ADM), tar(C), tee(C) 

Notes 



When logging in, XENIX truncates passwords to eight (8) characters; 
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Altos UNIX System V does not. Therefore, the user must not type 
more than eight characters when the password from the XENIX system 
is in effect. 

Passwordless accounts and other liberties XENIX allows are more re- 
stricted in Altos UNIX System V. To continue to use such poor secu- 
rity practices requires customizing the system defaults or the insecure 
accounts. 

Some standard accounts shipped with the system provoke warnings 
when the -e or -s options are specified. 

Some vendor's systems support specifying a nice(S) value in the com- 
ment field, or doing a chroot(S) to the home directory (called a 
sublogin). Both constructions are understood by addxusers, albeit 
sublogins are not supported in Altos UNIX System V and cause a 
warning. 
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adfmt 

formats SCSI hard disks 
Syntax 

/etc/adfmt device_name 

Description 



The adfmt command issues a format command to the SCSI disk de- 
vice name. device name should be the character-special device 
representing the whole SCSI disk, for example, /dev/rhdOO. 

Notes 



SCSI disks with embedded controllers are formatted as part of the 
manufacturing test procedure. Using adfint on these disks is unneces- 
sary. 

Files 



/dev/rhd?0 

See Also 

scsi(HW), hd(HW) 

Value Added 

adfint is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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asktime 



prompts for the correct time of day 
Syntax 



/etc/asktime 

Description 



This command prompts for the time of day. You must enter a legal 
time according to the proper format as defined below: 

[lyy]mmdd\hhmm 

Here the first mm is the month number; dd is the day number in the 
month; hh is the hour number (24-hour system); the second /nw is the 
minute number; yy is the last 2 digits of the year number and is 
optional. The current year is the default if no year is mentioned. 

Examples 



This example sets the new time, date, and year to "11:29 April 20, 
1985". 

Current system time is Wed Nov 3 14:36:23 PST 1985 
Enter time ( [yymmdd] hhmm) : 8504201129 

Diagnostics 



If you enter an illegal time, asktime prompts with: 

Try again : 

Notes 



asktime is normally performed automatically by the /etc/rc2 system 
startup scripts immediately after the system is booted; however, it 
may be executed at any time. The command is privileged, and CLn 
only be executed by the super-user. 

Systems which autoboot will invoke asktime automatically on reboot. 
On these systems, if you don't enter a new time or press return within 
1 minute of invoking asktime , the system will use the time value it 
has. If RETURN alone is entered, the time is unchanged. 
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Value Added 

asktime is an extension of AT&T System V provided in Altos UNIX 
System V. 
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atcronsh 



at and cron administration utility 
Syntax 



/usr/lib/ sy sadm/atcronsh 

Description 



atcronsh is the screen interface invoked by the sysadmsh(ADM) 
Jobs— >Authorize selection. It is used to specify users allowed to use 
the cron(C), at(C) and batchiC) commands. It also allows the at{C) 
and batch(C) prototype files to be edited. 

The program allows a system default for both cron(C) and at(C) and 
batch(C) to be given. The defaults can be: 

• none - No user ai^thorized 

• allow - All users allowed to use the commands unless a user is spe- 
cifically denied 

• deny - All users denied to use the commands unless a user is spe- 
cifically authorised 

The default setting decides whether an allow or deny file is to be used 
(deny file means /usr/lib/cron/cron.deny or at.deny, allow file means 
/usr/lib/cron/cron.deny or at.deny). 

For each user (unless the none system default has been chosen), a spe- 
cific authorization for both cron(C) and at(C) and batch(C) may be 
given. The allow and deny files are interpreted as follows: 

• if an allow file exists, and the user name appears in it, the user 
is allowed access. 

• if an allow file exists, access is denied 

• if a deny file exists and the user name appears in it, access id 
denied 

• if a deny file exists, access is allowed 

• access is denied 
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Files 



ATCRONSH (ADM) 



/usr/lib/cron/cron.allow 
/usr/lib/cron/cron.deny 
/usr/Iib/cron/at.allow 
/usr/lib/cron/at.deny 

See Also 



auditsh(ADM), authsh(ADM), at(C), backupsh(ADM), batch(C), 
cron(C), Ipsh(ADM), sysadmsh(ADM) 

Notes 



Invoking atcronsh(ADM) is not recommended; use the 
sysadmsh(ADM) Jobs— >Authorize selection. 

Value Added 



atcronsh is an extension of AT&T System V provided in Altos UNIX 
System V. 
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auditcmd 



command interface for audit subsystem activation, ter- 
mination, statistic retrieval, and subsystem notification 

Syntax 



auditcmd [ -e ] [ -d ] [ -s ] [ -c ] [ -m ] [ -q ] 

Description 



The auditcmd utility is used to control the audit subsystem. This com- 
mand may only be executed by processes with the configaudit kernel 
authorization since the audit device is used. 

auditcmd allows the specification of one of the following options: 

-e Enable the audit subsystem for audit record generation. The 
enabling of the audit subsystem initializes subsystem parame- 
ters from the /tcb/files/audit/audit_parms file. This file is 
established using the auditiJ[ADM) command. 

-s Inform the audit subsystem that a system shutdown is in pro- 
gress. The subsystem will continue audit record generation to 
a temporary directory on the root file system. The audit dae- 
mon is also modified so that it will survive the shutdown. The 
subsystem will continue to generate audit records until dis- 
abled. 

-d Disable the audit subsystem. All audit record generation 
ceases and a termination record is written to the audit trail. 
This record results in the termination of the audit daemon. 
The subsystem properly synchronizes to insure that the audit 
daemon has read all records from the audit trail before the 
system is allowed to terminate. 

-m Inform the audit subsystem that multi-user run state has been 
achieved and that alternate audit directories specified by the 
administrator using auditif are now mounted and available. 

-c Retrieve audit subsystem statistics from the audit device. 

-q Perform the specified option silently. Do not report errors 
attributable to the audit subsystem not being enabled at the 
moment. 
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See Also 



AUDITCMD (ADM) 



audit(HW), "Maintaining System Security," chapter of the System 
Administrator's Guide 

Diagnostics 



auditcmd returns 0 on success, 1 on command line argument error, and 
-1 on failure actions. Reasons for failure include parameter file incon- 
sistencies, lack of permission, and security database inconsistency. 

Value Added 



auditcmd is an extension of AT&T System V provided in Altos UNIX 
System V. 
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auditd 



read audit collection files generated by the audit sub- 
system and compact the records 

Syntax 



auditd [ -y ] [ -n ] 

Description 



auditd is the audit daemon process which is spawned whenever the 
audit subsystem is enabled. TTie audit subsystem continually generates 
audit records writing them to intermediate files called audit collection 
files. At any time, there may be many collection files since the subsys- 
tem continually switches files to ensure that no single file grows 
excessively large. 

The daemon is responsible for reading the audit collection file records 
fi-om the subsystem, compacting them to provide space savings, and 
writing the compacted records to files which will later be used for 
reduction. To read the records from the subsystem, the daemon uses 
the /dev/auditr device. The daemon exclusively reads this file which 
IS managCu uy mC su bsystem. Each read request returns a i/iOCrw Oj. 
data from a collection file. The audit subsystem insures that the data is 
returned in the proper order and also handles file management associ- 
ated with the multiple collection files. This provides the daemon with 
a single read focal point. 

As a block of data is returned to the daemon, it is optionally com- 
pacted and the record along with its size prepended is written to the 
current audit output file. Like the audit subsystem, the daemon is 
capable of writing many different output files in a number of adminis- 
trator specified directories to avoid overflowing any one file system. 
As each output file is written, the daemon records the name in a log 
file which is used by the reduction program. This log file provides an 
output file trail alleviating the need for the administrator to keep up 
with file generation or to recreate the sequence of output file writing. 
The compaction of output files and the selection of audit directories is 
controlled by the administrator interface utility auditsh(ADM). 

Each time the audit subsystem is enabled, a new audit session is creat- 
ed. The session is identified by a session ID which is used to stamp the 
output files generated by the audit daemon and the log file that identi- 
fies them, auditif is used to examine daemon log files in the 
/tcb/files/audit directory to identify the session and the date/time of 
the start and end of the session. In this manner, the administrator need 
not know the session ID but only the dates for which data reduction is 
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desired. 

When the daemon is started, a recovery mechanism is invoked to 
determine if the previous audit session was terminated normally. If 
abnormal termination occurred, there may be audit records written by 
the subsystem to collection files that were not read by the daemon and 
compacted to an audit output file. The daemon recovery mechanism 
provides the capability to recover these records and update the output 
files from the previous session as necessary. The recovery mechanism 
will interactively query whether recovery is desired if abnormal termi- 
nation occurred. The -y and -n options may be to used avoid the 
interactive question. 

The daemon also provides a mechanism whereby applications that are 
not privileged to open and write audit records to the audit device are 
able to send the daemon audit records. These are, in turn, written to to 
the audit subsystem. To provide this service, the daemon creates a 
message queue which only certain applications with specific permis- 
sion are able to send messages to. When one of the applications 
wishes to generate an audit record using this mechanism, the record is 
first constructed and then written to the message queue. The specific 
message queue is identified in the file 
/tcb/files/audit/audit_dmninfo. This file contains the audit dmninfo 
structure which is defined in the include file sys/audit.h. The first 
field is the process ID of the daemon and the second is the message 
queue identifier. After the message has been written to the queue by 
die application, the application will generate a SIGUSRl to the dae- 
mon indicating a message is waiting. The daemon responds by reading 
the message queue and writing the record to the audit subsystem de- 
vice. 

Files 



/dev/auditr 
/dev/auditw 

/tcb/files/audit/audit_dmninfo 
/tcb/files/audit/CAFLOG.xxxxxx 

See Also 



audit(HW), "Maintaining System Security," chapter of the System 
Administrator's Guide 

Diagnostics 



upon successful completion at the termination of auditing by the sub- 
system, the program exits with a status of 0. Otherwise, a diagnostic 
message is printed and the program exits with a status of -1. 
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Value Added 

auditd is an extension of AT&T System V provided in Altos UNIX 
System V. 
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auditsh 



menu driven audit administration utility 
Syntax 



/usr/lib/ sy sadm/auditsh 

Description 



auditsh is the screen interface invoked by the sysadmsh(ADM) 
System-^Audit selection. This selection controls the audit subsystem, 
allowing establishment of audit subsystem initialization parameters, 
specification of criteria for selecting output records during reduction, 
report generation, dynamic changing of subsystem parameters, and 
backup and restore of compacted audit output files. 

If the environment variable PAGER is set, the specified program is 
used to display reports sent to the terminal. 

See Also 



atcronsh(ADM), auditcmd(ADM), auditd(ADM), authsh(ADM), 
backupsh(ADM), Ipsh(ADM), reduce(ADM), sysadmsh(ADM) 

Notes 



Invoking auditsh(ADM) is not recommended; use the 
sysadmsh(ADM) System->Configure-»Audit selection. 

Value Added 



auditsh is an extension of AT&T System V provided in Altos UNIX 
System V. 
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authck 



check internal consistency of Autlientication database 
Syntax 



authck [ -p ] [ -t ] [ -s ] [ -f ] [ -c ] [ -a ] [ -V ] 

Description 



authck checks both the overall structure and internal field consistency 
of all components of the Authentication database. It reports all prob- 
lems it finds. The options and tests are as follows: 

-p Check the Protected Password database. A number of tests are 
performed. The Protected Password and /etc/passwd are 
checked for completeness such that neither contains entries not 
in the other. Once this is done, the fields common to the Pro- 
tected Password database and /etc/passwd are checked to make 
sure they agree. Then, fields in the Protected Password database 
are checked for reasonable values. For instance, all time stamps 
of past events are checked to make sure they have times less 
than that returned by time(S). 

-t Tne fields in the Terminal Control database are checked for rea- 
sonable values. All time stamps of past events are checked to 
make sure they have times less than returned by time . 

-s The Protected Subsystem database files are checked to ensure 
they correctly reflect the subsystem authorization entries in the 
Protected Password database. Each name listed in each subsys- 
tem file is verified against the Protected Password entry with the 
same name, so that no authorization is inconsistent between the 
files. Also, each Protected Password entry is scanned to ensure 
that all the privileges listed do in fact get reflected in the Pro- 
tected Subsystem database. If any inconsistencies are found, 
the administrator is given the option of fixing the Subsystem 
database automatically. 

-a This option is shorthand for turning on all the -p, -t, and -s, 
options. 

-V This options provides running diagnostics as the program 
proceeds. It also produces warnings on events that should not 
occur but otherwise do not harm the Authentication database 
and the routines operating on it. 
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Files 



AUTHCK(ADM) 



/etc/passwd - System password file 
/tcb/files/auth/*/* - Protected Password database 
/etc/auth/system/ttys - Terminal Control database 
/etc/auth/system/files - File Control database 
/etc/auth/subsystems/* - Protected Subsystem database 
/etc/auth/system/default - System Defaults database 

See Also 



integrity(ADM), getprpwent(S), getprtcent(S), getprfient(S), 
getprdfent(S), authcap(F), subsystem(S), "Maintaining System Secu- 
rity," chapter of the System Administrator's Guide 

Value Added 



authck is an extension of AT&T System V provided in Altos UNIX 
System V. 
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authsh 

administrator interface for autliorization subsystem 
Syntax 



/usr/lib/sysadm/authsh 

Description 



authsh is the screen interface invoked by the sysadmsh(ADM) 
Accounts selection to administer the authorization subsystem. It is a 
full screen menu driven interface that provides the functions necessary 
to control the generation and maintenance of user and system pass- 
words, the terminal database configuration, terminal and account 
locking, and the generation of administrator reports on system 
activity. 

The functions supported by the main level menu are: 



User This category of screen interfaces is provided for the 

setup and maintenance of user accounts and user 
account passwords. The screens are used to add, update, 
display, and delete user accounts from the system. 
Also, modifications to user account passwords or 
modifications to the various criteria controlling the 
generation of account passwords is accomplished using 
this menu option. 

System These options are provided for the maintenance of 
system-wide parameters like default privileges, pass- 
word expiration, password lifetime, single user pass- 
word requirement, restrictive password generation, and 
the delay time between login attempts. These parame- 
ters apply on a global system basis rather than a user 
account basis. 



Terminals The terminal database interface screens are used for the 
maintenance of the database entries to support the addi- 
tion, deletion, and update of terminal information. 
Additionally, this category includes the necessary 
screens for setting and clearing locks on specific termi- 
nals. 

Reports This category provides the administrator with a method 
of generating various reports on system activity. Report 
types include password database, terminal database, 
and login activity reports. 
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The interface program is located in the trusted computing base direc- 
tory /tcb/bin. 

See Also 



passwd(C), ''Maintaining System Security," chapter of the System 
Administrator's Guide 

Files 



/etc/group, 

/etc/passwd, 

/tcb/files/auth/[a-z]/* 

/tcb/files/biodb/[a-z]/*, 

/tcb/files/biodb/schema. 

Notes 



Invoking authsh(ADM) is not recommended; use the sysadmsh(ADM) 
Accounts selection. 

Value Added 



authsh is an extension of AT&T System V provided in Altos UNIX 
System V. 
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AUTOBOOT (ADM) 



automatically boots the system 
Description 



The system can be set up to go through the boot stages automatically 
(as defined in /etc/default/boot) when the computer is turned on 
(booted), provided no key is pressed at the boot(HW) prompt. 

If boot times out and AUTOBOOT=YES, then the word "auto" is 
passed in the boot string and init(M) is passed a -a flag. 

In addition, the TIMEOUT entry can be set to specify the number of 
seconds to wait before timing out. 

The autoboot procedure checks the file /etc/default/boot for the fol- 
lowing instructions on autobooting: 



AUTOBOOT=YES or NO 



MULTIUSER=YES or NO 



PANICBOOT=YES or NO 



RONLYROOT= YES or NO 



DEFBOOTSTR=bootstring 



Whether or not boot(HW) times out 
and loads the kernel, boot looks for 
this variable in the /etc/default/boot 
file on its default device. 

Whether or not init(M) invokes 
sulogin or proceeds to multiuser 
mode. 

Whether or not the system reboots 
after a panic(). This variable is read 
from /etc/default/boot by init. 

Whether or not the root filesystem is 
mounted readonly. This must be 
used only during installation, and not 
for a normal boot. It will effectively 
prevent writing to the filesystem. 

Set default bootstring to bootstring. 
This is the string used by boot when 
the user presses <RETURN> only to 
the "Boot:" prompt, or when boot 
times out. 
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SYSTrY=jc 



If X is 1, the system console device is 
set to the serial adapter at COM. If x 
is 0, the system console is set to the 
main display adapter. 



SLEEPTIME=/i 



Sets the time (in seconds) between 
calls to sync. 



TIMEOUT=/i 



where n is the number of seconds to 
timeout at the "Boot:" prompt 
before booting the kernel (if 
AUTOBOOT=YES). If TIMEOUT is 
unspecified, defaults to one minute. 



If either the /etc/default/boot file or the variable needed cannot be 
found, the variable is assumed to be NO. However, if the filesystem 
cannot be found, PANICBOOT is set to YES. 

If the UNIX mail system, mail(C), is installed on the system, the output 
of the boot sequence is mailed to root. Otherwise, the system 
administrator should check the file /etc/bootlog for the boot sequence 
output. The output of fsck (ADM) is temporarily saved in the file 
/dev/recover before it is moved to /etc/bootlog and finally may be 
sent to the system administrator via mail. 

Other boot options which take affect during autoboot are documented 
on the bootQkW) manual page. 



Files 



/etc/bootlog 
/etc/default/boot 



boot output log for autobooting systems 



boot information file 



/etc/rc2 



instructions for entering multiuser mode, 
includes mounting and checking additional 
filesystems 



/etc/sulogin 



executed at startup, prompts the user to press 
Ctrl-d for multiuser mode or to enter the root 
password for maintenance mode 



/dev/recover 



allows saving of fsck output 



/dev/scratch 



temporary fsck file for large filesystems 



See Also 



boot(HW), fsck(ADM), init(M) 
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AUTOBOOT(ADM) 



The utilities invoked during the boot procedure are passed the -a flag 
and time out only when the system autoboots. For example, 
asktime (ADM) times out after 30 seconds when the system autoboots, 
but waits for a response from the user any other time it is invoked. 

The previous boot modes of AUTO=CLEAN, DIRTY, NEVER have 
been retained for backwards compatibility, but are ignored if any of 
the newer modes are present. 

Value Added 



autoboot is an extension to AT&T System V developed in Altos UNIX 
System V. 
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backup 

performs UNIX backup functions 
Syntax 



backup [ -t ] [ -p I -c I -f files I -u "userl [ user2]" ] -d device 
backup -h 

Description 

The UNIX backup utility is a front-end for the cpio(C) utility. Use 
restore(ADM) to restore backups made with this utility. It is not 
recommended for routine system backups; use the sysadmsh(ADM) 
interface for system backups. 

-h produces a history of backups. Tells the user when the last com- 
plete and incremental/partial backups were done. 

-c complete backup. All files changed since the system was installed 
are backed up. 

-p incremental/partial backup. This option backs up only the files 
that have been modified since the date of the last backup. A com- 
plete backup must be done before a partial backup. 

-f backup files specified by the <files> argument. File names may 
contain characters to be expanded ( i.e., *, .) by the shell. The 
argument must be in quotes. 

-u backup a user's home directory. All files in the user's home direc- 
tory will be backed up. At least one user must be specified but it 
can be more. The argument must be in quotes if more than one 
user is specified. If the user name is "all", then all the user's home 
directories will be backed up. 

-d used to specify the device to be used. It defaults to 
/dev/rdsk/fOql5d (the 1.2M floppy). 

-t used when the device is a tape. This option must be used with the 
-d option when the tape device is specified. 
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A complete backup must be done before a partial backup can be done. 
Raw devices rather than block devices should always be used. The 
program can handle multi-volume backups. The program will prompt 
the user when it is ready for the next medium. The program will give 
you an estimated number of floppies/tapes that will be needed to do 
the backup. Floppies MUST be formatted before the backup is done. 
Tapes do not need to be formatted, except mini-cartridge tapes. If 
backup is done to tape, the tape must be rewound. 

xbackup is the equivalent utility for XENIX filesystems. 
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backupsh 



menu driven backup administration utility 
Syntax 



/usr/lib/sysadm/backupsh 

Description 



backupsh is the screen interface invoked by the sysadmsh(AT)M) 
Backups selection to administer the backup subsystem, backupsh 
allows scheduled and non scheduled backups to be taken. Complete 
filesystems or single files or directories may also be restored. It also 
allows the /usr/Iib/sysadmin/schedule file to be edited. 

Backupsh can be used with both UNIX and XENIX filesystems. If a 
UNIX filesystem is being used then backupsh calls cpio(C), if a 
XENIX filesystem is being used then backupsh calls xbackup(ADM) 
or xrestore(ADM). 

Refer atcronsh(ADM) for details of environment variables that 
backupsh uses, the usage is the same except that backpsh uses the spe- 
cific variable BACKUP instead of ATCRON. 

Files 



/usr/lib/sysadmin/schedule 

See Also 



atcronsh(ADM) auditsh(ADM), authsh(ADM), at(C), batch(C), 
cpio(C), cron(C), backup(ADM), lpsh(ADMX restore(ADM), 
sysadmsh(ADM) 

Notes 



Invoking backupsh(ADM) is not recommended; use the 
sysadmsh(ADM) Backups selection. 

Value Added 



backupsh is an extension of AT&T System V provided in Altos UNIX 
System V. 
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badtrk 



scans fixed disk for flaws and creates bad track table 
Syntax 



badtrk [ -e [ -m max ] ] [ -S major* minor* blk# [#_of_blocks] ] 
[ -s qtdn ] [ -f device ] 

Description 



Used chiefly during system installation, badtrk scans the media sur- 
face for flaws, creates a new bad track table, prints the current table, 
and adds and deletes entries in the table. Bad tracks listed in the table 
are "aliased' ' to good tracks, such that when a process tries to read or 
write a track listed in the bad track table, one of a replacement tracks 
is used instead. These replacement tracks are allocated when badtrk 
is run during installation. Changing the number of replacement tracks 
allocated may require re-installation of the operating system, so the 
number of replacement tracks allocated should be fairly large. 

To use badtrk, you must be in single user mode. (See 
shutdown(ADM)). 

Note that SCSI disks maintain their own low-level record of bad 
blocks, without employing the operating system's bad block table or 
any of its aliasing schemes. Use the -S option to change the low-level 
SCSI disk record directly. 



WARNING 

badtrk operates correctly with SCSI disks when used with the -S 
option only. Since only SCSI disks are currently supported, running 
badtrk with any other option (or interactively with no options) may 
damage or corrupt disk data. 



Options 



-f device 

Opens the partition device and reads the bad track table associated 
with that partition, device must be the active UNIX partition of a 
fixed disk: /dev/rhdaa for the first drive, /dev/rhdba for the 
second, and so on. The default is /dev/rhdaa. 
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-e Used by the installation procedure, the -e flag causes badtrk to 
change the size of the bad track table. 

WARNING: The -e flag should not be invoked by the user. Use of the 
-e option may restructure the hard disk, rendering much of the infor- 
mation stored on it unusable. 

-S majorff minor# block# [#_of_blocks] 

Re-assigns a bad block on a SCSI disk. The SCSI disk is identified 
by its major number majorif and minor number minortt. The block 
number is identified by the blocks argument. If more than this one 
block is to be identified, use the optional argument of blocks to 
specify the total number of blocks starting at blocktt. 

-m max 

Used only in non-interactive mode in conjunction with -e, -m sets 
the maximum number of bad tracks to max. 

-s arguments 

Invokes badtrk non-interactively, causing it to scan the disk for 
bad tracks and enter any errors found in the bad track table. The 
arguments specify either quick or thorough, and either destructive 
or non-destructive scan: 

[q]uick 
[t]horough 
[d]estructive 
[n]on-destructive 

The user should specify either q or t, and either d or n. 

Usage 



When badtrk is executed interactively, the program first displays the 
main menu: 

1. Print Current Bad Track Table 

2. Scan Disk (You can choose Read-Only or Destructive later) 

3. Add Entries to Current Bad Track Table by Cylinder/Head Number 

4. Add Entries to Current Bad Track Table by Sector Number 

5. Delete Entries Individually Fran Current Bad Track Table 

6. Delete All Entries Frcm Bad Track Table 

Enter your choice or ^q' to quit: 

You are prompted for option numbers, and, depending upon the option, 
more information may be queried for later. 
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A bad track table (option "1") might look like this: 



Defective Tracks 





Cylinder 


Head 


Sector Number (s) 


1. 


190 


3 


12971-12987 



Press <RETURN> to continue. 



Option "2" scans the disk for flaws. If changes have been made to 
your bad track table since you last updated the table on disk (or since 
you entered badtrk), you will be asked if you want to update the disk 
with the new table before scanning. You should answer "y" to save 
your changes, 'n' if you don't want to save changes made up to this 
point. Next you are prompted to specify the kind of scan you wish to 
perform: either quick or thorough, and either destructive or non- 
destructive. Choosing a destructive scan will cause all data in the 
scanned region to be lost. After you respond to these prompts, badtrk 
begins its scan. You can interrupt a scan by typing "q" at any time. 
You are then prompted to continue the scan or return to the main 
menu. 

As the program finds flawed tracks, it displays the location of each bad 
track. An example error message might be: 



wd: ERROR : on fixed disk ctlr=0 dev=0/47 block=31434 cmd=00000020 
status=00005180, sector = 62899, cylinder/head = 483/4 

(You may see this kind of message if there is a read or write error dur- 
ing the scanning procedure.) 

When the scan is complete, the main menu reappears. The program 
automatically enters any detected flaws in the bad track table. 

If your disk is furnished with a flaw map, you should enter these flaws 
into the bad track table. Select either option "3" or "4", depending 
upon the format of the flaw map furnished with your disk. Enter the 
defective tracks, one per line. 

When you are satisfied that badtrk contains a table of the desired 
flaws, quit the badtrk program by entering "q" at the main menu. 

If badtrk was invoked with the -e flag (which should only occur when 
called by hdinit, during the installation procedure), and the disk con- 
tains a valid division table, the following message is displayed prior to 
the badtrk menu: 
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This device contains a valid division table. Additional 
(non-root) filesystems can be preserved across this reinstallation. 
If you wish to be able to preserve these file systems later, you must 
not change the current limit of the bad track table, which is 
n bad tracks. Do you wish to leave it unchanged? <y/n>: 

If you respond "y", you will not be prompted later to enter a new 
limit for the size of your bad track table. You can add or delete 
entries, but you will not be allowed to increase the maximum number 
of bad tracks allocated. If you respond **n" and the size of your bad 
track table is changed, your disk division table will be destroyed. 

If you do not have a valid disk table or you selected "n" when 
prompted, you are prompted for the number of replacement tracks to 
allocate. TTiere will be a recommended number of replacement tracks 
to allocate based on the number of known bad tracks plus an 
allowance for tracks that may go bad in the future. You should choose 
to allocate at least the recommended number of replacement tracks. 
Make your choice carefully, because if you want to change this 
amount later, you will have to reinstall. 

Before exiting, badtrk will ask whether you wish to update the device 
with the new bad track table. If you wish to save you changes, answer 
"y"- If you wish to leave the bad track table as it was before running 
badtrk^ answer "n". 

Notes 



This utility can only be used in single-user mode. 

If a bad spot develops in the boot blocks or system tables at the very 
beginning of the fdisk partition, reinstallation is required. 

Files 



/etc/badtrk 

Value Added 



badtrk is an extension of AT&T System V provided in Altos UNIX 
System V. 
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system initialization procedures 
Syntax 



/etc/bcheckrc [ -a ] 
/etc/brc 

Description 



These shell procedures are executed via entries in /etc/inittab by 
init(M) whenever the system is booted (or rebooted). 

First, the bcheckrc procedure checks the status of the root file system. 
If the root file system is found to be bad, bcheckrc repairs it. When 
invoked with the -a (autoboot) flag, bcheckrc will run without opera- 
tor intervention, init calls bcheckrc with the -a flag when the system 
autoboots. 

Then, the brc procedure clears the mounted file system table, 
/etc/mnttab, and puts the entry for the root file system into the mount 
table. 

After these two procedures have executed, init checks for the initde- 
fault value in /etc/inittab. This tells init in which run level to place 
the system. Since initdefault is initially set to 2, the system will be 
placed in the multi-user state via the /etc/rc2 procedure. 

Note that bcheckrc should always be executed before brc. Also, these 
shell procedures may be used for several run-level states. 

See Also 



boot(HW), fsck(ADM), init(M), rc2(ADM), shutdown(ADM) 
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captoinfo 



convert a termcap description into a terminfo descrip- 
tion 

Syntax 



captoinfo [-v ..,] [-V] [-1] [-w width] file ... 

Description 



The captoinfo command looks in file for termcap descriptions. For 
each one found, an equivalent terminfo (F) description is written to 
standard output, along with any comments found, A description which 
is expressed as relative to another description (as specified in the 
termcap tc- field) will be reduced to the minimum superset before 
being output. 

If no file is given, then the environment variable TERMCAP is used 
for the file name or entry. If TERMCAP is a full path name to a file, 
only the terminal whose name is specified in the environment variable 
TERM is extracted from that file. If the environment variable 
TERMCAP is not set, then the file /etc/termcap is read. 

-V print out tracing information on standard error as the pro- 

gram runs. Specifying additional -v options will cause 
more detailed information to be printed. 

-V print out the version of the program in use on standard 

error and exit. 

-1 cause the fields to print out, one to a line. Otherwise, the 

fields will be printed several to a line, up to a maximum 
width of 60 characters. 

-w change the output to width characters. 

Fiies 



/usr/lib/terminfo/?/* compiled terminal description data base 

Notes 



Certain termcap defaults are assumed to be true. For example, the bell 
character {terminfo be I) is assumed to be 'G. The linefeed capability 
(termcap nl) is assumed to be the same for both cursor down and 
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scroll Jorvfard (terminfo cudl and ind, respectively.) Padding infor- 
mation is assumed to belong at the end of the string. 

The algorithm used to expand parameterized information for termcap 
fields such as cursor _position (termcap cm, terminfo cup) will some- 
times produce a string which, though technically correct, may not be 
optimal. In particular, the rarely used termcap operation %n will pro- 
duce strings that are especially long. Most occurrences of these non- 
optimal strings will be flagged with a warning message and may need 
to be recoded by hand. 

The short two-letter name at the beginning of the list of names in a 
termcap entry, present for backwards compatibility, has been 
removed. 

Diagnostics 



tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for 
an invalid 'tc=' entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not Boolean, numeric, or string. 

wrong type given for the Boolean (numeric, string) termcap code cc. 

The Boolean termcap entry cc was entered as a numeric 
or string capability. 

the Boolean (numeric, string) termcap code cc is not a valid name. 
An unknown termcap code was specified. 

tgetent failed on TERM=term. 

The terminal type specified could not be found in the 
termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an '@', as in 
':bs@:'. Giving a null string could cause incorrect 
assumptions to be made by the software which uses 
termcap or terminfo . 

a function key for cc was specified, but it already has the value vv. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the 
key cc already had a value assigned to it. 



March 15, 1989 



CAPTOINFO-2 



CAPTOINFO (ADM) 



CAPTOINFO (ADM) 



the unknown termcap name cc was specified in the ko termcap capability. 

A key was specified in the ko capability which could not 
be handled. 

the vt character v (info //) has the value jcc, but ma gives n. 

The ma capability specified a function key with a value 
different from that specified in another setting of the 
same key. 

the unknown v/ key v was specified in the ma termcap capability. 

A VI (C) key unknown to captoinfo was specified in the 
ma capability. 

Warning: termcap sg (nn) and termcap ug {nn) had different values. 

terminfo assumes that the sg (now xmc) and ug values 
were the same. 

Warning: the string produced for // may be inefficient. 

The parameterized string being created should be rewrit- 
ten by hand. 

Null termname given. 

The terminal type was null. This is given if the environ- 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 

See Also 



infocmp(ADM), tic(C), curses (S), terminfo(F) 
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checkaddr 



MMDF address verification program 
Syntax 



/usr/mmdf/bin/checkaddr [-w] [addresses... ] 

Description 



The checkaddr program is used to check the validity of an address 
within the local mail system (MMDF). checkaddr can be given 
addresses either on the command line, one address per argument, or a 
list of addresses can be given to checkaddr on the standard input, one 
address per line. The latter mode is use for checking the addresses in 
a mailing list by saying '*c/iecfa2iidr< mailing-list-file", checkaddr 
announces each address on a separate line and follows the address 
with its status (normally "OK"), checkaddr uses submit(ADM) to do 
the address verification. 

If the -w option is given, checkaddr causes submit to generate a 
detailed submission tracing. This can sometimes be useful to help 
find problems in alias files or mailing lists. 

See Also 



submit(ADM) 
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checkque 



MMDF queue status report generator 
Syntax 



checkque [-fpsz] [-tage[m]] [-c channel channel ...] 

Description 



checkque reports on the amount of mail waiting in the MMDF distri- 
bution queue. It indicates the total number of messages and the size of 
the queue directory. It then lists the number of messages waiting for 
each transmission channel. 

The -c option allows one or more channel names to be specified. If 
present, checkque restricts it's report to the named channels. 

The -f option causes checkque to print the name of the oldest queued 
message for each channel, -p causes only channels with "problems" 
to be listed. Problems are defined as channels which have mail wait- 
ing for over some "problem threshold." The default "problem 
threshold" is 24 hours. The -t option is used to change the "problem 
threshold." A number of hours (or minutes, if "m" is appended) 
should appear without a space after the -t. -s forces an abbreviated 
summary listing instead of the normal multi-line report, -z causes 
channels with no messages queued to be skipped in the report. 

Since the mail queue usually is protected from access by any uid, 
except MMDF, checkque should be run under root or MMDF uid. It 
should not be made setuidQ to mmdf unless you want to allow non- 
staff members to see the queue status. 

Most configurations will have only two channels. One is for local 
delivery and the second is for off-machine relaying, such as by calling 
out or by being called up, or by attaching to ArpaNet hosts. Locd 
delivery usually happens at the time of submission, so it is rare that 
any mail is waiting in it. Mail in other outbound queues is processed 
by deliver according to your site parameters, either by running deliver 
as a background daemon or by periodically firing it up via cron. 

Files 



quedfldir[]/addr 
quedfldir[]/msg 
quedfldir[]/q.* 
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phase-directory/ channel/* 

See Also 

phs(S), deliver(ADM) 

Author 

Dave Crocker, Dept. of E.E., Univ. of Delaware 
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checkup 



Report on MMDF problems 
Syntax 



/usr/mmdf/bin/checkup [-p -\[digit]] 

Description 



The checkup command is used to check aspects of the MMDF system 
configuration. Normally, checkup reports on all problems that are 
encountered, including correct states. Displayed problems are pre- 
fixed by two asterisks (**); information that is advisory is enclosed in 
square brackets ([]). 

The two optional flags to checkup specify how much information is 
displayed. The -p option reports only problems detected by checkup. 
This is useful for day-to-day checking of the system, such as mailing 
the output to the postmaster alias. 

The -V flag takes an optional digit which ranges from 1 (the same as 
the -p) option, to level 7 which displays all information. 

Some of the displayed information, such as that about permissions 
modes varies by site conventions and may not have widespread signi- 
ficance. In particular it is common for sites to allow group read, write, 
or execute on files that checkup expects to be protected more care- 
fully. Use of group permissions can greatly ease administration 
efforts for system managers without compromising security. Warn- 
ings regarding "others" permissions should be examined. 
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chg_audit 

enables and disable auditing for the next session 
Syntax 

/tcb/Iib/chg_audit [on] 

Description 

chg audit enables and disable auditing for the next session (next 
reboot). It edits the /etc/inittab and /etc/conf/cf.d/init.base file to add 
or remove the audit startup command when the system is rebooted. 
The command is normally invoked by the auditsh(ADM). 

If on is specified, then auditing is enabled. If no argument is given, 
then the audit lines are removed from the inittab files. 

Fiies 

/etc/inittab 

/etc/conf/cf.d/init.base 

See Also 

auditsh(ADM), sysadmsh(ADM) 

Value Added 

chg audit is an extension of AT&T System V provided in Altos UNIX 
System V. 
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chroot 



changes root directory for command 
Syntax 



chroot newroot command 

Description 



The given command is executed relative to the new root. The mean- 
ing of any initial slashes (/) in pathnames is changed for a command 
and any of its children to newroot. Furthermore, the initial working 
directory is newroot. 

Notice that: 

chroot newroot command >x 

creates the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root pathname is always relative to the current root even if a 
chroot is currently in effect. The newroot argument is relative to the 
current root of the running process. Note that it is not possible to 
change directories to what was formerly the parent of the new root 
directory; i.e., the chroot command supports the new root as an abso- 
lute root for the duration of the command. This means that "A." is 
always equivalent to *7". 

See Also 



chdir(S) 

Notes 



Exercise extreme caution when referencing special files in the new 
root file system. 

command must be under newroot or command is reported: 
command', not found 
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Standards Conformance 



chroot is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cleanque 



send warnings and return expired mail 
Syntax 



cleanque [ -w ] 

Description 



cleanque removes extraneous files from the imp and msg subdirec- 
tories of the MMDF "home queue" directory. It also sends warnings 
for mail which has not been fully delivered after "wamtime" hours 
following submission. Finally, it retums mail which has not been fully 
delivered after "failtime" hours after submission. "Wamtime" and 
"failtime" are defined in the MMDF mfndftailor(F) file. 

Generally, cleanque should be run by cron, once a day, but may be run 
at any time to free up space. 

The optional argument, -w, can be used if you are running cleanque 
manually and want to see what the program is doing. 

See Also 



queue(F), deliver(ADM) 

Notes 



cleanque does not currently remove extraneous files from the individ- 
ual queues (q.* subdirectories). 
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cleantmp 



remove temporary files in directories specified 
Syntax 



/usr/lib/cleantmp 

Description 



cleantmp removes temporary files in directories specified in 
/etc/default/cleantmp under the variable TMPDIRS. By default, /tmp 
and /usr/tmp are examined. Users can add to the list of directories, 
separating each directory with a space. Files in these directories 
which are not accessed within the last n days will be removed, where 
n is the number of days specified under the variable FILEAGING in 
/etc/default/cleantmp. By default, FILEAGING is 7. Users can 
change the number of days for FILEAGING. /usr/lib/cleantmp is run 
as a cron job every day at 3:00a.m. Refer to 
/usr/spool/cron/crontabs/root on the system. The super user can edit 
this file to change the frequency and time at which /usr/lib/cleantmp 
is run. If the directories specified do not exist or if they are mount 
points and the file system are not mounted, cleantmp will send mail to 
root saying that the directory does not exist. 

The format of /etc/default/cleantmp is as follows: 

FILEAGING=7 
TMPDIRS=/tmp /usr/tmp 

Files 

/etc/default/cleantmp 

See Also 



rc2(ADM) 

Value Added 



cleantmp is an extension of AT&T System V provided in Altos UNIX 
System V. 
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ciri 



clears inode 
Syntax 



/etc/ciri filesystem i-number ... 

Description 



clri writes zeros on the 64 bytes occupied by the inode numbered i- 
number. Filesystem must be a special filename referring to a device 
containing a file system. After clri is executed, any blocks in the 
affected file will show up as "missing" if the file system is checked 
with /j'c^( ADM), Use clri only in emergencies and exercise extreme 
care. 

Read and write permission is required on the specified filesystem de- 
vice. The inode becomes allocatable. 

The primary purpose of this routine is to remove a file which, for some 
reason, does not appear in a directory. If you use clri to destroy an 
inode which does appear in a directory, track down the entry and 
remove it. Otherwise, when the inode is reallocated to some new file, 
the old entry will still point to this file. At that point removing the old 
entry will destroy the new file. The new entry will again point to an 
unallocated inode, so the whole cycle is likely to be repeated again 
and again. 

See Also 



fsck(ADM), ncheck(ADM) 

Notes 



If the file is open, clri is likely to be ineffective. 
This utility does not work on DOS filesystems. 
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configure 



kernel configuration program 
Syntax 



/etc/conf/cf.d/configure [ options ] [ resource=value ... ] 

Description 



The configure program determines and alters different kernel 
resources. For end users, using configure is easier than modifying the 
system configuration files directly. For device driver writers, 
configure avoids the difficulties of editing configuration files that 
have already been edited by an earlier driver configuration script. 

You must move to the /etc/conf/cf.d to execute configure. 

Resources are modified interactively or with command-line argu- 
ments. Adding or deleting device driver components requires the 
command-line options. 

The next paragraphs discuss how to use configure interactively. 
Command-line options are discussed in the "Options" section. 

Before using configure , to modify the system configuration files, use 
the following command to make a backup copy of the kernel. 

cp /unix /unix.oId 

Interactive Usage 

configure functions interactively when no options (including 
resource=value) are given or when -f is the only option specified on 
the command line. 
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When you invoke configure interactively, you first see a category 
menu that looks something like this: 



f 




Disk and Buffers 


1. 




2. 


Character Buffers 




3. 


Files, Inodes, and Filesystems 




4. 


Processes, Memory Management and Swapping 




5. 


Clock 




6. 


MultiScreens 




7. 


Message Queues 




8. 


Semaphores 




9. 


Shared Data 




10. 


System Name 




11. 


Streams Data 




12. 


Event Queues and Devices 




13. 


Hardware Dependent Parameters 




14. 


Remote File sharing Parameters 



Select a parameter category to reconfigure 

by typing a number from 1 to 14, or type 'q' to quit: 



To choose a category, enter its number (e.g., "1" for "Disk Buffers"), 
then press (Return). 

Each category contains a number of configurable resources. Each 
resource is presented by displaying its true name, a short description, 
and its current value. For example, for the "Disk Buffers" category 
you might see: 

NBUF: total disk buffers. 
Currently determined at system start up: 
NSABUF: system-addressable (near) disk buffers. 
Currently 10: 

NHBUF: hash buffers (for disk block sorting) . 
Currently 128: 

To keep the current value, simply press (Return). Otherwise, enter an 
appropriate value for the resource, then press (Return), configure 
checks each value to make sure that it is within an appropriate range. 
If not, configure warns you that the value is inappropriate and will 
confirm that you want to override the recommended value. 

To exit from configure , enter q at the category menu prompt. If any 
changes are made, configure asks if it should update the configuration 
files with the changes. To keep the old configuration values, enter n 
at this prompt, and no changes are made. Otherwise, enter y and con- 
figure updates the required system configuration files. After 
configure has completed, the kernel is ready for linking. 
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To link the kernel, enter: 

/etc/conf/cf.d/link_unix 

Linking may take a few minutes. After the kernel is linked, enter the 
following command to reboot the system to run the new kernel: 

/etc/shutdown 

Next, you see the boot prompt: 

Boot 



Press (Return). The system is now running the new kernel. 

Options 



The command line options are designed for writers of driver-installa- 
tion shell scripts. You can configure drivers, remove driver definitions 
from the configuration files, and modify some driver attributes, all 
from the command line. There are also options for querying the 
current driver configuration. 

configure uses the following options: 

-a [fund fund ... ] 

-b 

-c 

-d [funcl func2 ... ] 

-f master Jile [ dfile ] 

-g dev name handler I dev riame 

-h dev name 

-j [prefix] [NEXTMAJOR] 

-1 priority Jevel 

-m major dev number 

-o 

-s 

-t 

-V interrupt jyector [ interrupt _yector2. .. ] 
-w 

-X 

-y resource 

-A address address 

-C channel 

-D 

-G 

-H 

-I address address 
-J address address 
-M maximum minimum 
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-0 
-P 
-R 
-S 

-T interrupt _scheme 

-U number of subdevices 

-V interrupt _yector 

-Y 

-Z 

-m, -b, and -c 

These options are used to define which driver is being referenced. 
Following -m must be the major device number of ^e driver. If 
you are configuring a block driver, -b must appear; if you are con- 
figuring a character driver, -c must appear. Both are used when 
configuring a driver with both kinds of interfaces. 

-s When adding or deleting a streams module, use this option with the 
-h option and instead of -m, -b, and -c. For a streams driver, use it 
with -m and -c. 

-a and -d 

Each option is followed by a list of functions to add or delete, 
respectively. These are the names of the functions that appear 
within bdevsw[ ] or cdevsw[ ], as appropriate, plus the names of 
the initialization, clock poll, halt, and interrupt routines, if present, 
plus the name of the tty structure pointer, configure enforces the 
rules that all of a driver's routines must have a common prefix, and 
that the prefix be 2-4 characters long. 

-h This option is used to give the driver or streams module name 
when tiie name is different from the prefix or when no prefix is 
specified as in the case of the streams module. The name can be 
1-8 characters long. 

-j When followed by a prefix used by a driver, the major device num- 
ber is displayed. When followed by NEXTMAJOR, the smallest 
major device number is displayed. 

-V This option modifies the system notion of the vectors on which this 
device can interrupt. 

-1 This sets the interrupt priority level of the device, which is almost 
always the same as the type of spl{ ) call used: a driver that inter- 
locks using spl5{ ) almost always has an interrupt priority level of 
5. Use of Siis option in new drivers is not recommended. 

-f Much of the configuration data is maintained in two files, whose 
default names are mdevice and mtune. The -f option can be used 
to specify alternate names. Note that if -f is the only option 
present, the program is still interactive. 
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-w When specifying a parameter value, this option suppresses warning 
messages. 

-o This is the override flag. When invoked non-interactively, this 
option overrides the minimum and maximum values that are other- 
wise enforced. No warnings are given. This option has no effect 
on interactive commands. 

-X This dumps all the resource prompts known to configure. These 
reveal the name, description, and current value of each parameter 
capable of being reconfigured. Category prompts are not dumped. 

-y The -y option displays the current value of the requested parame- 
ter. 

-t This option displays nothing (except possibly error messages). 
However, it has a return value of 1 if a driver corresponding to the 
given combination of -m, -b, -c and options is already configured, 
and returns 0 if no such driver is present. 

-g This option is used to add or remove graphics input (GIN) device 
handlers. Devices such as mice, bitpads, and keyboards may have 
handlers to turn their input data into "events." The -g flag may be 
given one argument that is interpreted as a device name. That GIN 
device is removed from the configuration files. If the -g flag has 
two arguments, the second is a handler for that device, and the de- 
vice is added to the files. If it was already present, its handler is 
updated and the user is informed. Multiple devices may be added 
or removed by specifying -g multiple times. 

-A This option, followed by two values that are taken to be hexadeci- 
mal I/O addresses, returns the name of the device with the I/O 
address conflict. 

-C Followed by an integer, this option used with -a indicates the DMA 
channel that the device uses. The default is not to use DMA . 

-D This option used with the -a option adds to the device driver the 
characteristic that the driver can share its DMA channel; -D used 
with the -d option deletes this characteristic. The default is not to 
share. 

-G This option with -a adds the G characteristic to the driver; -G with 
-d deletes the G characteristic. This characteristic indicates 
whether or not the device uses an interrupt, even though an inter- 
rupt is specified in the sdevice entry. This is used when you want 
to associate a device to a specific device group. The default is not 
to set this characteristic. 
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-H This option with -a or -d adds or deletes the characteristic that the 
driver supports hardware that distinguishes it from those that are 
entirely software (pseudo devices). The default is to set this 
characteristic. 

-I This option is followed by two values that are the hexadecimal 
start and end I/O addresses. The default values are zero. 

-J The option is followed by two values that are the hexadecimal start 
and end controller memory addresses. The default values are zero. 

-M 

This option followed by two integers states the maximum and min- 
imum number of devices that can be specified in the sdevice file. 
The default is a maximum of 1 and a minimum of 0. 

-O This option with -a or-d indicates whether or not the lOA range of 
the device can overlap that of another device. The default is no. 

-P When used with -a or -d, adds or deletes an ignore "I" flag in the 
device mdevice entry. The "I" flag allows the configuration build 
utilities to ignore a devices pack.d directory (useful to the mpt/spt) 
driver. 

-R This option with -a or-d indicates whether or not the driver is 
required in the kernel all the time. The default is yes. 

-S This option with -a or-d indicates whether or not the driver has one 
sdevice entry only. The default is no. 

-T This option, when followed by an argument, states the type of 
interrupt scheme the device uses. The possible arguments are: 

0 The device does not require an interrupt line. 

1 The device requires an interrupt line. If the de- 
vice supports more than one controller, each 
controller requires a separate interrupt. 

2 The device requires an interrupt line. If the de- 
vice supports more than one controller, the con- 
trollers share the same interrupt. 

3 The device requires an interrupt line. If the de- 
vice supports more than one controller, the con- 
trollers share the same interrupt. Multiple de- 
vice drivers having the same interrupt priority 
level can share this interrupt. 

The default is 0. 
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-U This option, when followed by an integer, encodes a device- 
dependent numeric value in the sdevice file to indicate the number 
of subdevices on a controller or a pseudo device. The integer must 
be a value that lies within the maximum and minimum number of 
devices specified in the mdevice file. The default is 1. 

-V This option, followed by a vector value, returns the name of the de- 
vice with the vector conflict. 

-Y This option with -a or-d indicates whether or not to configure a 
driver into the kernel. Specifying -a puts a "Y" in the configura- 
tion field of the driver's sdevice entry; specifying -d puts an "N" 
in this field. The default is to put a "Y". 

-Z This option indicates that a device can have more than one entry in 
the mdevice file. The SCSI driver is an example of a driver that 
needs this feature. The option is usually used when adding a new 
entry or deleting a particular entry in the mdevice file. Using -d 
with -Z removes only the mdevice entry. Using -d without -Z 
removes the mdevice entry and the sdevice entry. 

Setting Command-Line Parameters 

Any number of arguments can be given on the command line of the 
form resource=value. These arguments can be given at the same time 
as an add or delete driver request, but must follow all the driver-con- 
figuration arguments on the command line. 

If one or more instances of resource-value are the only arguments on 
the command line, the changes are made non-interactively. If the 
values given are outside the permissible range for a parameter, no 
action is taken unless the -o option is included to override them. 

Some resources have values that are character strings. In this case, 
their values must be enclosed within the characters \" . The quotes are 
syntactically necessary for them to be used as C-language strings, and 
the backslashes protect the quotes from being removed by the shell. 

Examples 



Print out the current value of NCLIST: 

configure -y NCLIST 

Return 1 if character major device 7 and vector 3 are already config- 
ured: 

configure -t -v 3 -m 7 -c 
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Add a clock-time polling and initialization routine to the already con- 
figured "foo" driver, a hypothetical character driver at major device 
#17: 

configure -a foopoU fooinit -c -m 17 

Delete the "foo" driver: 

configure -m 17 -d -c 

Add a new "hypo" driver, a block driver with a character interface. It 
absorbs 3 different interrupt vectors, at priority 6: 

configure -a hypoopen hypoclose hyporead hypowrite hypoioctl \ 
hypostrategy hypoprint hypointr -b -c -1 6 -v 17 42 49 -m 10 

Add a new streams module with prefix "grb" and name "garble": 

configure -s -a grbinit -ti garble 

Files 



/etc/conf/cf.d/mdevice 

/etc/conf/cf.d/sdevice 

/etc/conf/cf.d/mtune 

/etc/conf/cf.d/stune 

/etc/conf/cf.d/mevent 

/etc/conf/cf.d/sevent 

See Also 



idconfig(ADM), link_unix(ADM), majorsinuse(ADM), 
routines(ADM), vectorsinuse(ADM), mdevice(F), mtune(F), 
sdevice(F), stune(F), event(M), "Tuning System Performance" in the 
System Administrator's Guide 

Value Added 



configure is an extension of AT&T System V provided in Altos UNIX 
System V. 
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consoleprint 

print /usr/adm/messages or any file to a serial printer 
attached to the printer port of a serial console 

Syntax 

consoleprint [ file ] 

Description 

consoleprint prints the file /usr/adm/messages to a printer attached to 
the printer port of a serial console. If a filename is specified, it is 
printed instead, consoleprint is normally run by a system administra- 
tor to get a hardcopy version of the system console messages. 

This command uses the file /etc/termcap. 

Fiies 

/etc/termcap 

See Also 

lprint(C) 

Notes 

The only terminals currently supported with entries in /etc/termcap are 
the Tandy DT-100 and DT-1, and the Hewlett-Packard HP-92. 

Terminal communications parameters (such as baud rate and parity) 
must be set up on the terminal by the user. 

Value Added 

consoleprint is an extension of AT&T System V provided in Altos 
UNIX System V. 
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crash 



examine system images 
Syntax 



/etc/crash [ -r ] [ -d dumpfile ] [ -n namelist ] [ -o offset ] 
[ -w outputfile ] 

Description 



The crash command is used to examine the system memory image of a 
live or a crashed system by formatting and printing control structures, 
tables, and other information. Command line arguments to crash are 
dumpfile, namelist, offset, and outputfile. 

Dumpfile is the file containing the system memory image. The default 
dumpfile is Idevlmem. 

If the -r option is used, then dumpfile is assumed to contain a system 
memory image as dumped after a UPS power failure shutsave opera- 
tion. The information stored in the restart header is then displayed. 
This option causes crash to display restart information only, and will 
not enter a normal session. Typically, the -r option is used in conjunc- 
tion with -d /dev/restart. 

The text file namelist contains the symbol table information needed 
for symbolic access to the system memory image to be examined. The 
default namelist is lunix. If a system image from another machine is 
to be examined, the corresponding text file must be copied from that 
machine. The offset is used to specify the starting location of the 
memory dump relative to the beginning of dumpfile. The default is 0 
(zero). If the system memory image is a UPS shutsave dump (i.e., in 
/dev/restart), then an offset of 1024 must be used, since in this case 
the actual memory image begins at offset 1024, after the restart 
header. 

When the crash command is invoked, a session is initiated. The output 
from a crash session is directed to outputfile. The default outputfile is 
the standard output. 

Input during a crash session is of the form: 

function [ argument ... ] 

^h&re, function is one of the crash functions described in the Functions 
section of this manual page, and arguments are qualifying data that 
indicate which items of the system image are to be printed. 
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The default for process-related items is the current process for a run- 
ning system and the process that was running at the time of the crash 
for a crashed system. If the contents of a table are being dumped, the 
default is all active table entries. 

The following function options are available to crash functions wher- 
ever they are semantically valid. 

-e Display every entry in a table. 

-f Display the full structure. 

-p Interpret all address arguments in the command line as physical 
addresses. 

-s process 

Specify a process slot other than the default. 
-wfile 

Redirect the output of a function to file. 

Note that if the -p option is used, all address and symbol arguments 
explicitly entered on the command line will be interpreted as physical 
addresses. If they are not physical addresses, results will be incon- 
sistent. 

The functions mode, defproc, and redirect correspond to the function 
options -p, -s, and -w. The mode function may be used to set the 
address translation mode to physical or virtual for all subsequently 
entered functions; defproc sets die value of the process slot argument 
for subsequent functions; and redirect redirects dl subsequent output. 

Output from crash functions may be piped to another program in the 
following way: 

function [ argument ... ] ! shell_command 

For example, 

mount ! grep rw 

will write all mount table entries with an rw flag to the standard out- 
put. The redirection option (-w) cannot be used with this feature. 

Depending on the context of the function, numeric arguments will be 
assumed to be in a specific radix. Counts are assumed to be decimal. 
Addresses are always hexadecimal. Table slot arguments are always 
decimal. Table slot arguments larger than the size of the function table 
will not be interpreted correctly. Use the findslot command to translate 
from an address to a table slot number. Default bases on all arguments 
may be overridden. Tlie C conventions for designating the bases of 
numbers are recognized. A number that is usually interpreted as 
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decimal will be interpreted as hexadecimal if it is preceded by Ox and 
as octal if it is preceded by 0. Decimal override is designated by Od, 
and binary by Ob. 

Aliases for functions may be any uniquely identifiable initial substring 
of the function name. Traditional aliases of one letter, such as p for 
proc, remain valid. 

Many functions accept different forms of entry for the same argument. 
Requests for table information will accept a table entry number or a 
range. A range of slot numbers may be specified in the form a-b where 
a and b are decimal numbers. An expression consists of two operands 
and an operator. An operand may be an address, a symbol, or a num- 
ber; the operator may be +, -, *, /, &, or I . An operand which is a num- 
ber should be preceded by a radix prefix if it is not a decimal number 
(0 for octal. Ox for hexadecimal, Ob for binary). The expression must 
be enclosed in parentheses (). Other functions will accept any of 
these argument forms that are meaningful. 

Two abbreviated arguments to crash functions are used throughout. 
Both accept data entered in several forms. They may be expanded 
into the following: 

table_entry = table entryl range 

start_addr = addressi symboll expression 

Functions 



?[-wfile] 

List available functions. 

!cmd 

Escape to the shell to execute a command. 

adv [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the advertised table. 

base [ -w file ] number ... 

Print number in binary, octal, decimal, and hexadecimal. A number 
in a radix other than decimal should be preceded by a prefix that 
indicates its radix as follows: Ox, hexadecimal; 0, octal; and Ob, 
binary. 

buffer [ -w file] [ -format ] bufferslot 
or 
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buffer [ -w file] [ -format ] [ -p ] start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. The follow- 
ing format designations are recognized: -b, byte: -c, character; -d, 
decimal; -x, hexadecimal; -o, octal; -r, directory; and -i, inode. If 
no format is given, the previous format is used. The default format 
at the beginning of a crash session is hexadecimal. 

buflidr[-f] [-wfile] [ [ -p ] table.entry ... ] 
Alias: buf. 

Print system buffer headers. 

callout [ -w file ] 
Alias: c. 

Print the callout table. 

dballoc [ -w file ] [ class ... ] 

Print the dballoc table. If a class is entered, only data block alloca- 
tion information for that class will be printed. 

dbfree [ -w file ] [ class ... ] 

Print free streams data block headers. If a class is entered, only 
data block headers for the class specified will be printed. 

dblock [ -e ] [ -w file ] [ -c class ... ] 

or 

dblock [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Print allocated streams data block headers. If the class option (-c) 
is used, only data block headers for the class specified will be 
printed. 

defproc [ -w file ] [ -c ] 

or 

defproc [ -w file ] [ slot ] 

Set the value of the process slot argument. The process slot argu- 
ment may be set to the current slot number (-c) or the slot number 
may be specified. If no argument is entered, the value of the previ- 
ously set slot number is printed. At the start of a crash session, the 
process slot is set to the current process. 

dis [ -w file ] [ -a ] start_addr [ count ] 

Disassemble from the start address for count instructions. The 
default count is 1. The absolute option (-a) specifies a non- 
symbolic disassembly. 

ds [ -w file ] virtual_address ... 

Print the data symbol whose address is closest to, but not greater 
than, the address entered. 
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file [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Alias: f. 

Print the file table. 

findaddr [ -w file ] table slot 

Print the address of slot in table. Only tables available to the size 
function are available to findaddr. 

findslot [ -w file ] virtual_address ... 

Print the table, entry slot number, and offset for the address 
entered. Only tables available to the size function are available to 
findslot. 

fs [ -w file ] [ [ -p ] table_entry ... ] 

Print the file system information table. 

gdp[-e] [-f] [-wfile] [ [ -p ] table_entry ... ] 
ftint the gift descriptor protocol table. 

gdt [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the global descriptor table, 

help [ -w file ] function ... 

Print a description of the named function, including syntax and 
aliases. 

idt [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the interrupt descriptor table. 

inode[-e] [-f] [-wfile] [ [ -p ] table_entry ... ] 
Alias: i. 

Print the inode table, including file system switch information. 

kfp [ -w file ] [ value ] 

Print the frame pointer for the start of a kernel stack trace. If the 
value argument is supplied, the kfp is set to that value. 

Ick [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Alias: 1. 

F*rint record-locking information. If the -e option is used or table 
address arguments are given, the record lock list is printed. If no 
argument is entered, information on locks relative to inodes is 
printed. 

Idt [ -e ] [ -w file ] [ -s process ] [ [ -p ] table_entry ... ] 

Print the local descriptor table for the given process, or for the 
current process if none is given. 

linkblk [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the linkblk table. 
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map [ -w file ] mapname ... 

Print the map structure of mapname. 

mbfree [ -w file ] 

Print free streams message block headers. 

mblock [ -e ] [ -w filename ] [ [ -p ] table_entry ... ] 
Print allocated streams message block headers. 

mode [ -w file ] [ mode ] 

Set address translation of arguments to virtual (v) or physical (p) 
mode. If no mode argument is given, the current mode is printed. 
At the start of a crash session, the mode is virtual. 

mount [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Alias: m. 

Print the mount table. 

nm [ -w file ] symbol ... 

Print value and type for the given symbol. 

od [ -p ] [ -w file ] [ -format ] [ -mode ] [ -s process ] start_addr [ count ] 
Alias: rd. 

Print count values starting at the start address in one of the follow- 
ing formats: character (-c), decimal (-d), hexadecimal (-x), octal 
(-o), ASCII (-a), or hexadecimal/character (-h), and one of the fol- 
lowing modes: long (-1), short (-t), or byte (-b). The default mode 
for character and ASCII formats is byte; the default mode for 
decimal, hexadecimal, and octal formats is long. The format -h 
prints both hexadecimal and character representations of the 
addresses dumped; no mode needs to be specified. When format or 
mode is omitted, the previous value is used. At the start of a crash 
session, the format is hexadecimal and the mode is long. If no 
count is entered, 1 is assumed. 

panic 

Print the latest system notices, warnings, and panic messages from 
the limited circular buffer kept in memory. 

pcb [ -w file ] [ process ] 

Print the process control block (TSS) for the given process. If no 
arguments are given, the active TSS for the current process is 
printed. 

pdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 

The page descriptor table of the designated memory section and 
segment is printed. Alternatively, the page descriptor table start- 
ing at the start address for count entries is printed. If no count is 
entered, 1 is assumed. 
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pfdat[-e] [-wfile] [ [ -p ] table_entry ... ] 
Print the pfdata table. 

proc [-e] [ -f ] [ -w file ] [ [ -p ] table_entry ... #procici ... ] 

or 

proc[-f] [-wfile] [-r] 
Alias: p. 

Print the process table. Process table information may be specified 
in two ways. First, any mixture of table entries and process ids 
may be entered. Each process id must be preceded by a #. Alterna- 
tively, process table information for executable processes may be 
specified with the executable option (-r). The full option (-f) 
details most of the information in the process table as well as the 
region table for that process. 

qrun [ -w file ] 

Print the list of scheduled streams queues. 

queue [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print streams queues. 

quit 

Alias: q. 

Terminate the crash session. 

rcvd[-e] [-f] [-wfile] [ [ -p ] table_entry ... ] 
Print tiie receive descriptor table. 

redirect [-wfile] [-c] 

or 

redirect [ -w file ] [ file ] 

Used with a file name, redirects output of a crash session to the 
named file. If no argument is given, the file name to which output 
is being redirected is printed. Alternatively, the close option (-c) 
closes the previously set file and redirects output to the standard 
output. 

region [-e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the region table, 

sdt [ -e ] [ -w file ] [ -s process ] section 

or 

sdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 

The segment descriptor table for the current process is printed. 
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search [ -p ] [ -w file ] [ -m mask ] [ -s process ] pattern start_addr count 
Print tfie long words in memory that match pattern, beginning at 
the start address for count long words. The mask is anded (&) with 
each memory word and the result compared against the pattern. 
The mask defaults to OxflBBBBBff. 

size [ -w file ] [ -x ] [ structure_name ... ] 

ftint the size of the designated structure. The (-x) option prints the 
size in hexadecimal. If no argument is given, a list of the structure 
names for which sizes are available is printed. 

sndd [-e] [-f] [-wfile] [ [ -p ] table_entry ... ] 
Print tile send descriptor table. 

srmount [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the server mount table. 

stack [ -w file ] [ process ] 
Alias: s. 

Dump stack. If no arguments are entered, the kernel stack for the 
current process is printed. The interrupt stack and the stack for the 
current process are not available on a running system. 

Stat [ -w file ] 

Print system statistics. 

stream [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry ... ] 
Print the streams table. 

strstat [ -w file ] 

Print streams statistics. 

trace [ -w file ] [ -r ] [ process ] 
Alias: t. 

Print kernel stack trace. The kfp value is used with the -r option. 

ts [-W file ] virtual_address ... 

Print closest text symbol to the designated address. 

tty[-e] [-f] [-wfile] [-ttype[[-p]table_entry ...]] 
Valid types: co, cl, c2 (console, coml, com2). 
Print the tty table. If no arguments are given, the tty table for the 
console is printed. If the -t option is used, the table for the single 
tty type specified is printed. If no argument follows the type 
option, all entries in the table are printed. A single tty entry may 
be specified from the start address. 

user [ -f ] [ - w file ] [ process ] 
Alias: u. 

Print the ublock for the designated process. 
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var [ -w file ] 
Alias: v. 

Print the tunable system parameters. 

vtop [ -w file ] [ -s process ] start_addr ... 

Print the physical address translation of the virtual start address. 



Files 



/dev/mem 
/dev/restart 



system image of currently running system 
system image of a UPS shutsave dump 



See Also 



upsconfig(ADM) 
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custom 



installs specific portions of the UNIX System 
Syntax 



custom [-od] [-irla [package] ] [-m device] [-f [file] ] 

Description 



With custom you can create a custom installation by selectively in- 
stalling or deleting portions of the UNIX system, custom is executable 
only by the super-user and is either interactive or can be invoked from 
the command line with several options. 

Files are extracted or deleted in packages. A package is a collection 
of individual files. 

You can also install additional sets. You can list the available pack- 
ages by using the custom command as described next. 

Usage 



To use custom interactively, enter: 
custom 

The custom main menu appears with the following options: 
Install 

Allows a product or system to be added, 

A window is first opened to select the system set or product. When 
a system or product is selected, you are given the choice of adding 
the "Entire Product", "Packages" or "Files". When "Entire 
Product' ' is chosen, custom calculates which installation volumes 
(distribution media) are needed, then prompts for the correct vol- 
ume numbers. 

If "Packages" is chosen, a list of all available packages in the 
currently selected set is displayed. Each line describes the pack- 
age name, whether the package is fully installed, not installed or 
partially installed, the size of the package (in 512 byte blocks), and 
a one line description of the package contents. 
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Multiple packages can be specified by marking them with the 
space bar. The selected packages will appear with asterisks. 
When executed, custom will prompt for insertion of the necessary 
volumes. (You cannot use custom to install the entire RTS pack- 
age if that package is already partially installed. If this situation 
comes up, use fixperm(ADM) to determine which files are missing, 
and then use custom to install each file individually.) 

If "Files" is chosen, you are prompted to select the package and 
then the file names, custom then prompts for volumes. 

Remove 

Deletes the correct files in the specified package/product. Select 
the product or package to be deleted just as you select a product or 
package to install. 

List 

Lists all files in the specified package or all packages in a product 
set. 

Quit 

Leaves custom. 



Options 



Three arguments are required for a completely non-interactive use of 
custom: 

A set identifier 
(-0 or -d) 

A command 
(-i, -r, -1,-f, or -a) 

And either one or more package names, or a file name 

If any information is missing from the command line, custom prompts 
for the missing data. 

Only one of -o, or -d may be specified. These stand for: 
-o Operating System 
-d Development System 
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Only one of -i, -r, -1, -f, or -a may be specified, followed by an argu- 
ment of the appropriate type (one or more package names, or a file 
name). These options perform the following: 

-i Install the specified package(s) 

-r Remove the specified package(s) 

-1 List the files in the specified package(s). 

-f Install the specified file. 

-a Add a new product 

The -m flag allows the media device to be specified. The default is 
/dev/install (which is always the 0 device, as in /dev/fdO). This is very 
useful if the system has a 5.25-inch drive on /dev/fdO and a 3.5-inch 
floppy on /dev/fdl, and it is necessary to install 3.5-inch media. For 
example: 

custom -m /dev/rfdl96ds9 

this will override the default device and use the one supplied with the 
-m flag. 



Files 



/etc/perms/* 



See Also 



fixperm(ADM), df(C), du(C), xinstall(ADM) 



Notes 



If you upgrade any part of your system, custom detects if you have a 
different release and prompts you to insert the floppy volume that 
updates the custom data files. Likewise, if you insert an invalid prod- 
uct or a volume out of order, you will be prompted to reinsert the 
correct volume. 
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Upon installation of the operating system, the RTS package is always 
entirely installed. 

Value Added 



custom is an extension to AT&T System V provided in Altos UNIX 
System V. 
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dbmbuild 



builds the MMDF hashed database of alias and routing 
information 

Syntax 



/usr/mmdf/table/dbmbuild [ -nvdk] ] [ database [ table ...] ] 

Description 



dbmbuild reads the tables specified in the MMDF tailor file into a 
hashed database for use in quickly verifying addresses and efficiently 
assigning channels to submitted messages. Whenever you change 
MMDF alias or routing information in any way, you must rebuild the 
hashed database by logging in as mmdf and running dbmbuild from the 
lusrimmdfltable directory. 

If no database file is specified, the default database mmdfdbm is 
used. If no table files are specified, all tables listed in the tailor file 
are used. In particular, three tables are read for each channel defini- 
tion: the list of authorized sources, the list of authorized destinations, 
and the table of names/aliases for that channel. Also, the remaining 
tables (MTBL and MDMN) are read. 

The options are: 

n Create a new database. If this option is omitted, dbmbuild updates 
an existing database. If no options at all are specified, -n is 
assumed; however, if you give any options (even -v), you must 
specify the -n option if you want to create a new database. 

V Run in verbose mode, displaying information during table pro- 
cessing. 

d Run in debug mode, reporting everything that happens. 

k Keep going. If a file is mentioned that does not exist, ignore it. 
This option might be an appropriate default at some sites. 

Appropriate locks are placed on the database so that dbmbuild can 
safely be run while MMDF is in operation. 
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DBMBUILD (ADM) 



/usr/mmdf/mmdftailor 
/usr/mmdf/table/alias.list 
/usr/mmdf/table/alias.user 
/usr/mmdf/table/* .chn 
/usr/mmdf/table/*.dom 

$(tbldbm).dir database directory 



See Also 



tables(F), mmdftailor(F), dbm(S), "Setting Up Electronic Mail" in 
the System Administrator's Guide 



$(tbldbm).pag 
$(tbldbm).lck 
$(tbldfldir)/* 



database pages 
database locking file 
various tables that form the database 
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dcopy 



copy UNIX filesystems for optimal access time 
Syntax 



/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsize[:isize]] inputfs outputfs 

Description 



The dcopy command copies filesystem inputfs to outputfs. Inputfs is 
the device file for the existing file system; outputfs is the device file 
to hold the reorganized result. This utility is for UNDC fileystems 
only. For the most effective optimization, inputfs should be the raw 
device and outputfs should be die block device. Both inputfs and out- 
putfs should be unmounted file systems. 

With no options, dcopy copies files from inputfs compressing direc- 
tories by removing vacant entries, and spacing consecutive blocks in a 
file by the optimal rotational gap. The possible options are: 

'SX supply device information for creating an optimal organi- 

zation of blocks in a file. The forms of X are the same as 
the -s option offsck(ADM). 

-an place the files not accessed in n days after the free blocks 

of the destination file system (default for n is 7). If no n is 
specified, then no movement occurs. 

-d leave order of directory entries as is (default is to move 

sub-directories to the beginning of directories). 

-V currently reports how many files were processed, and how 

big the source and destination freelists are. 

-ffsize[:isize] 

specify the outputfs file system and inode list sizes (in 
blocks). If the option (or lisize) is not given, the values 
from the inputfs are used. 

dcopy catches interrupts and quits, and reports on its progress. To ter- 
minate dcopy send a quit signal, followed by an interrupt or quit. 

See Also 



fsck(ADM), mkfs(ADM), ps(C) 
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deliver 



MMDF mail delivery process 
Syntax 



deliver [-bdpsw] [-cchan,chan] [-Imins] [-thrs] [-mmaxsort] [- 
Llogfile] [-Tsecs] [-Vloglevel] [messagel ... messageN] 

Description 



The deliver program handles the management of all mail delivery 
under the MMDF mail system, deliver does not deliver mail directly, 
but instead calls on MMDF channels to handle actual delivery. 
deliver' s actions are guided by the MMDF tailoring file, 
/usr/mmdf/mmdftailor, and by the command line options. The pro- 
gram can run as either a daemon or a user-invoked program. The pro- 
gram may be called to process the entire mail queue or just handle 
some explicitly named messages. When possible, deliver will attempt 
to process messages in the order received, deliver also maintains a 
cache of host information on a per-channel basis which allows hosts 
which are unavailable for delivery to be skipped until available. 

deliver first builds a list of channels to process, either from the com- 
mand line or composed of all the non-passive channels in the system. 
Next, a list of messages to process is collected, either from the com- 
mand line or by scanning the mail queue for for each channel. If the 
the number of messages in the queue for a given channel is more than 
maxsort (set in tailor file or on command line), the queue directory for 
that channel will be processed in the order read, without sorting by 
submission time. If a list of messages is given on the command line, 
no sorting will take place and the messages will be delivered in the 
order specified. The sorting keys are (in order): channel, submission 
time, and finally host. This causes many accesses to the messages but 
minimizes the invocation of channel programs. 

deliver is setuid to the superuser to allow it to set its real and effective 
UID and GID to that of the MMDF user. 

The following options may be used to alter deliver'^ behavior: 

-b Background mode. Causes deliver to run as a background daemon 
making periodic sweeps over the mail queues looking for 
undelivered mail and attempting deliver. The invoker must be the 
MMDF user or the superuser to use this option, deliver attempts 
delivery for all eligible messages, then sleeps, and then repeats the 
process. The default sleep time is 10 minutes but it can be 
changed (see the -T option below). 
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-cchannel 1 ,channel2,. .. 

Channel selection. A comma- separated list of channels to be pro- 
cessed. 

-d Already in "quedfldir". This option will cause deliver to assume 
it is already in the mail queue and therefore it will not issue an ex- 
plicit chdir(). This is useful if you wish to have deliver operate on 
an alternate mail queue hierarchy, mainly for testing. 

-Iminutes 

Sets the "time-to-live" for entries in the dead-host cache. This 
time defaults to 2 hours. The dead host cache is used to prevent 
attempts to deliver to hosts that are known to be down. The 
"time-to-live" is given in minutes. If the number of minutes is 
negative, dead host caching is disabled. 

-mmaxsort 

Sets the sort threshold. If there are more than maxsort messages in 
a given channel's queue, then they are processed in directory order 
without first sorting by submission time. If -m is not specified, the 
value of maxsort is given in the tailor file by MMAXSORT. 

-p Pickup only mode. Indicates that the invoker would like to pickup 
a passive mail channel. 

-s Force linear search of the mail queue. Normally deliver will 
deliver messages in the order they were received which seldom 
matches the order in the directory. This option is useful if the 
queue gets so large that deliver can no longer deal with sorting the 
queue in a reasonable time. 

-thrs 

Time limiting. This option prevents deliver from attempting to 
deliver messages which have been in the queue for more than hrs 
hours. For efficiency reasons, this option only applies when the 
queue is being sorted. If an explicit list of messages was given on 
the command line, if the -s option is in effect, or there are more 
messages than the maxsort threshold (see the -m option), then time 
limiting does not occur. 

-w Watch the delivery. Causes deliver to print informative messages 
on the standard output as it is attempting delivery. This option is 
passed onto the channel programs which also give informative 
messages. 

-Llogfile 

Sets the logfile for this deliver to the file specified. The default is 
to log into the file msg.log in the MMDF log directory. This option 
is only available to the Superuser and MMDF. 
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-Tseconds 

Sets the sleep time between background sweeps of the mail queue. 
This defaults to 10 minutes. 

-Vloglevel 

Sets the logging level for this deliver to the level specified. The 
loglevel should be a valid mmdf logging level string such as FTR. 
This option is only available to the superuser and MMDF. 

See Also 



submit(ADM), queue(F), mmdftailor(F) 

Value Added 



deliver is an extension of AT&T System V provided in Altos UNIX 
System V. 
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delete a virtual disk 

Syntax 

/altos/bin/del.vd [n] 

Description 

The del.vd utility removes a virtual disk. The system must be in 
singleuser mode to use this command. The virtual disk will have been 
previously created by add.vd(ADM) or vdutil(ADM). 

If n is not specified on the command line, the script prompts you for 
the virtual disk number. Once you reply with a correct number, the 
system removes the designated virtual disk. 

Options 

n Delete virtual disk number n. 

See Also 

add.vd(ADM), vdinfo(ADM), vddaemon(ADM), vdutil(ADM) 

Note 

Also refer to "Virtual Disks" in the System Administrator's Guide. 
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dials a modem 
Syntax 



/usr/Iib/uucp/dialX ttyname telno speed 
/usr/lib/uucp/dialX -h ttyname speed 
/usr/lib/uucp/uuchat ttyname speed chat-script 

Description 



/usr/lib/uucp/diaLY dials a modem attached to ttyname . (X is a dialer 
name, such as HA1200.) The -h option is used to hang up the modem. 

uucico(ADM), ct(C), and cu(C) use /usr/lib/uucp/dialX. Four dialer 
programs are distributed. dialHA12 is for the Hayes® Smartmodem 
1200 and 1200B (and compatibles). dialHA24 is for the Hayes® 
Smartmodem 2400 (and compatibles). dialVA3450 is for the Racal- 
Vadic VA3450-Series dialers. dialTBIT is for the Telebit Trailblazer. 
Source for these is provided in their respective .c files. 

uucico(ADM) invokes dial, with a ttyname, telno (phone number), 
and speed, dial attempts to dial the phone number on the specified 
line at the given speed. When using the dialHA12 or dialHA24 speed 
can be a range of baud rates. The range is specified with the form: 

lowrate - highrate 

where lowrate is the minimum acceptable connection baud rate and 
highrate is the maximum. The dial program returns the status of the 
attempt through the following dial return codes: 

bit 0x80 = 1 

The connection attempt failed. 
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bitsOxOf = 

If bit 0x80 is a 1, then these bits are the dialer error code: 



0 general or unknown error code. 

1 line is being used. 

2 a signal has aborted the dialer. 

3 dialer arguments are invalid. 

4 the phone number is invalid. 

5 the baud rate is invalid or the dialer could not 
connect at the requested baud rate. 

6 can't open the line. 

7 ioctl error on the line. 

8 timeout waiting for connection. 

9 no dialtone was detected. 

10 unused. 

1 1 unused. 

12 unused. 

13 phone is busy. 

14 no carrier is detected. 

15 remote system did not answer. 



Error codes 12-15 are used to indicate that the problem is at the 
remote end. 

If bit 0x80 is a 0, then these bits are used to indicate the actual con- 
nection baud rate. If 0, the baud rate is the same as the baud rate used 
to dial the phone number or the highest baud rate if a range was 
specified. Otherwise, these four bits are the CBAUD bits in the struct 
termio c_flag and the struct sgttyb sg_ispeed and sg_ospeed tty ioctl 
structures. 

You can copy and modify one of the files /usr/lib/uucp/dialHA12.c 
etc., to use a different modem. There is a makefile in /usr/lib/uucp 
which should be modified for the new dialer, and can be used to com- 
pile the new program. 
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If you create a dial program for another modem, send us the source. 
User generated dial programs will be considered for inclusion in 
future releases. 

The dial program to be used on a particular line is specified in the fifth 
field of the entry for that line in /usr/lib/uucp/Devices. If there is no 
dial program of that name, then mcico, ct, and cu use a built-in dialer, 
togetfier with the chat-script of that name in /usr/Iib/uucp/Dialers. 

dial -h is executed by getty when it is respawned on a line shared 
between dial-in and dial-out. If there is no dial program, then getty 
uses /usr/lib/uucp/uuchat, passing it the & chat-script from 
/usr/lib/uucp/Dialers. 

Files 



/usr/lib/uucp/Devices 

/usr/lib/uucp/dialVA3450 

/usr/lib/uucp/dialHA 1 2 

/usr/lib/uucp/dialHA24 

/usr/lib/uucp/makefile 

/usr/lib/uucp/dialTBIT 

/usr/lib/uucp/uuchat 

See Also 



ct(C), cu(C), uucico(ADM), dialers(F), getty (M) 

Notes 



You must have the Development System installed in order to compile 
and install a new dial program. 

Value Added 



dial is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 



Racal Vadic 3450 dialer 
Hayes Smartmodem 1200/12006 dialer 
Hayes Smartmodem 2400 dialer 
Makefile to compile new dialer 
Telebit Trailblazer dialer 
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diskusg 



generate disk accounting data by user ID 
Syntax 



diskusg [options] [files] 

Description 



diskusg generates intermediate disk accounting information from data 
in files , or the standard input if omitted, diskusg outputs lines on the 
standard output, one per user, in the following format: uid login 
#blocks 



where 

uid the numerical user ID of the user. 

login the login name of the user; and 

#blocks the total number of disk blocks allocated to this user. 



diskusg normally reads only the inodes of file systems for disk 
accounting. In this case, files are the special filenames of these de- 
vices. 

diskusg recognizes the following options: 

-s the input data is already in diskusg output format. 

diskusg combines all lines for a single user into a single 
line. 

-V verbose. Print a list on standard error of all files that 

are charged to no one. 

-ifnmlist ignore the data on those file systems whose file system 
name is in fnmlist. Fnmlist is a list of file system 
names separated by commas or enclosed within quotes. 
diskusg compares each name in this list with the file 
system name stored in the volume ID [see 
labelitikmA)]. 

-p file use file as the name of the password file to generate log- 

in names, /etc/passwd is used by default. 
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-u file write records to file of files that are charged to no one. 

Records consist of the special file name, the inode num- 
ber, and the user ID. 

The output of diskusg is normally the input to acctdisk [see 
acc? (ADM)] which generates total accounting records that can be 
merged with other accounting records, diskusg is normally run in 
dodisk [see acctsh{PsI>M)]. 

Examples 



The following will generate daily disk accounting information: 

for i in /dev/dsk/Osl /dev/dsk/0s3; do 

diskusg $i > dtnp. 'basenaine $i' & 

done 
wait 

diskusg -s dtnp.* | sort +0n +1 | acctdisk > disktacct 

Files 



/etc/passwd used for user ID to login name conversions 

See Also 



acct(ADM), acctsh(ADM), acct(F) 

Standards Conformance 



diskusg is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 
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displaypkg 

display installed packages 

Syntax 

displaypkg 

Description 

The displaypkg command will list the names of all the AT&T-style 
UNIX packages that were installed using the installpkg command. 

See Also 

installpkg(ADM), removepkg(ADM) 

Note 

This command does not work on packages installed with 
custom(ADM). 
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disk dividing utility 
Syntax 



divvy -b block_device -c character_device -s scsi_index 
[-1 scsi_log_name] [-v virtual_drive] [-p physical_drive] [-i] 
[-m] [-n] [-U] 

Description 



divvy divides an fdisk(ADM) partition into a number of separate areas 
known as "divisions". A division is identified by unique major and 
minor device numbers and can be used for a filesystem, swap area, or 
for isolating bad spots on the device. 

With divvy you can: 

• Divide a disk oxfdisk partition into separate devices. 

• Create new filesystems. 

• Change the size of filesystems. 

• Remove filesystems. 

Options 



Options to divvy are: 

-b block device 

Major device number of block interface. 

-c character device 

Major device number of character interface. 

-s scsijndex 

Indicate which SCSI drive to divide, identified by the logical SCSI 
index number scsi jndex (which can range from 0 to 51). Cannot 
use with the -b , -c , or -p options. 

-1 scsi Jog name 

For a SCSI disk, indicate which physical disk to divide, as 
identified by the logical SCSI index number scsi Jog name . (This 
number should be the same as the one you used when executing 
fdisk -f dev name . Cannot use with -b , -c , or -p options. 
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-V virtualjdevice 

For dividing a virtual drive. ("Virtual" here means a disk parti- 
tion, not a striped or mirrored disk.) 

-p physical drive 

For dividing one of several physical disks that share the same con- 
troller. 

-i Installation only. Disk being divided will contain a root filesystem 
on division 0. 

-m Disk being divided should be made into a number of mountable 
filesystems. 

-n Installation only; non-interactive option. Disk being divided will 
contain the following: 

root fileystem on division 0 
swap on division 1 
usr fileystem on division 2 
scratch fileystem on division 5 

Note that a /u filesystem may be present also, but is created only 
during an interactive installation. 

-u Non-destructive add. 

Usage 



The device being divided must be a block device with a character 
interface. For example, to use diwy on a device with a block- 
interface major number 1 and character interface number of 1, enter: 

divvy -b 1 -c 1 

The -s and -1 options should be used together when dividing SCSI hard 
disks. The -s option expects a logical SCSI index number, scsi index, 
to indicate the actual drive to be installed. This number may range 
from 0 to 51. The -I option indicates the physical disk name to be 
added. This character should be the same as the one used when exe- 
cuting the fdisk -f dev name command for this disk. The name that is 
chosen will have no correlation to where the disk actually resides on 
the system. It indicates when you added the disk. The actual disk can 
be determined through the major and minor device numbers, or by 
using the scsinfo (ADM) utitlity . 

Note that you cannot use the -s and -1 options with ESDI or ST506 
drives, nor can they be used with the -b , -c , or -p options. 
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The -V option specifies which virtual drive to divide. The default is 
the active drive. Here, "virtual drive" is the same as an MS-DOS par- 
tition. Virtual drive numbers are determined with the fdisk(ADM) 
utility. 

The -p option allows division of one of several physical disks sharing 
a controller, diwy defaults to the first physical device numbered "0." 
To access a second physical disk, use the -p 1 option. 

The -i option is used during installation. It specifies the device being 
divided will contain a root filesystem. With this option, device nodes 
are created relative to the new root, generally a hard disk, instead of 
the current root, often an installation floppy. A root filesystem, a /usr 
filesystem, a swap area, and a recover area are created, divvy prompts 
for tiie size of the swap area. If the disk is large enough, fiien divvy 
prompts for a separate /u (user) filesystem. diwy also prompts for 
block-by-block control over the layout of the filesystem(s). If the root 
filesystem is large enough to require a scratch filesystem, (more than 
40,000 blocks) then diwy will prompt for whether one should be cre- 
ated. 

The -m option is used for initial installation on devices that will not 
be used as the root. It causes the user to be prompted for a number of 
filesystems. 

The -u option creates device nodes for a valid division table without 
destroying its present contents. It will create the default name hddpv, 
where d represents the physical disk name given the -1 option. The p 
represents the partition number specified by the -v option, and the v 
respresents the division number. If the -v option is not given, the 
value for Y defaults to 5, and the device nodes will point to the active 
partition. 

When diwy is invoked from the command line, you see a main menu: 



n[aine] Nanie or rename a division. 

c[reate] Create a new file system on this division. 

t[ype] Select or change filesystem type on new filesystems. 

p[revent] Prevent a new file system frcan being created on this. . . 

s[tart] Start a division on a different block. 

e[nd] End a division on a different block. 

r[estore] Restore the original division table. 



Please enter your choice or 'q' to quit: 

To choose a command, enter the first letter of the command, then press 
RETURN. 
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The divvy division table might look something like this: 







1 


1 


-H +. 




Name 


1 Type 


New FS 


# 


1 First Block | 


Last Block 1 
69408 1 


root 


H 

1 AFS 


^ 

1 no 


f — 
0 


-H +. 

1 01 


swap 


1 NON FS 


1 no 


1 


1 1388181 


152020 1 


usr 


1 AFS 


1 no 


2 


1 694091 


1388171 


u 


1 AFS 


1 no 


1 3 


1 1520211 


1720201 




1 NOT USED 


1 no 


4 


1 -1 


-1 




1 NOT USED 


1 no 


1 5 


1 -1 


-1 


recover 


1 NON FS 


1 no 


1 6 


1 1720211 


1720301 


hdaa 


1 WHOLE DISK 


1 no 


1 7 


1 01 


1730391 






^ 


^ — 







172031 IK blocks for divisions, 1008 IK blocks reserved for the system 

divvy also displays information about block allocation for system 
tables and bad tracks. 

You can change the name of the device with the 'n' command, divvy 
prompts you for the division number (from the diwy table displayed 
^bove), then for a new name. 

The 'c' command causes a given division to become a new, empty 
filesystem when you exit from diwy . After using the 'c' command, 
you will see a 'yes' in the 'New File System?' column. If you use 
command 'p,' the 'yes' in the 'New File System?' column will change 
to a 'no', and the contents of the division will not change. The 'c' 
command must be used when changing the size of a filesystem. 

With the 's' or 'start' command, you can start a division on a different 
block number. With the 'e' or 'end' command, you can end a division 
on a different block number. 

You can use these commands to change the size of a partition. For 
example, if your disk is similar to the one in the sample divvy table 
above, and you want to make the u filesystem larger and the swap area 
smaller, do this: 

Make the swap area smaller with the 'e' command. 

Use the 's' command to make the u division bigger. 

Use the 'c' command to recreate the u filesystem. 

Note that if any of the divisions overlap, diwy will complain when 
you try to exit and put you back in the menus to correct the situation. 

The 'r' or 'restore' command restores the original partition table. This 
is useful if you make a serious mistake and want to return to where 
you started. 
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When you exit from diwy, you are prompted whether you want to 
save any changes you made, or exit without saving the changes. At 
this time, you can also go back to the diwy menu, and may also have 
the option to reinstall the original, default partition table. If you elect 
to save your changes, the new partition table will be written to the 
hard disk and any new filesystems (designated with the 'c' command) 
will be created. 

See Also 



badtrk(ADM), fdisk(ADM), fsck(ADM), fsname(ADM), hd(M), 
mkdev(C), mkfs(C), mknod(C) 

Notes 



divvy requires kernel level support from the device driver. If divvy 
lists the size of a disk as **0" blocks, or displays the following error 
messages, the device may not support dividing: 

cannot read division table 

or: 

cannot get drive parameters 

These errors may also occur if the prerequisite programs dparam, 
fdisk and badtrk are not run correctly. 

If you change the size of filesystems (such as In) after you have 
installed an AFS filesystem, you will have to use the 'c' command to 
re-create the filesystem and reinstall the files that are kept there. This 
is because the free list for that filesystem has changed. Be sure to 
backup the files in any filesystem you intend to change, using 
backup {kT>M), tar(C), or cpio(C), before you run diwy. To change 
the size of the root filesystem, the operating system must be rein- 
stalled. 

During installation, if the filesystem on division 0 (generally root) 
becomes or remains large enough to require a scratch area during /5c^, 
and one does not already exist, diwy prompts for whether one should 
be created. (The resulting filesystem, /dev/scratch, is used by auto- 
boot if it runs fsck. /dev/scratch should also be entered when fsck 
prompts for a scratch file name, provided that the filesystem being 
checked is not larger than the root filesystem.) If all disk divisions 
have been used up, diwy will not prompt for a scratch filesystem, even 
if the root filesystem is large enough to require one. 

This utility uses 512-byte blocks. 
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SCSI Conversion 



The following table shows how the SCSI index number for a SCSI 
hard disk translates into its major number and minor number. 

Device numbers are allocated to hard disks on a first-come- first-served 
basis, regardless of host adapter type, host adapter number controller 
number, or LUN. 
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Logical 


Major 


Base Minor 


SCSI 


Device 


Device 


Index 


Number 


Number 


0 


64 


0 


1 


64 


64 


2 


64 


128 


3 


64 


192 


4 


65 


0 


5 


65 


64 


6 


65 


128 


7 


65 


192 


8 


66 


0 


9 


66 


64 


10 


66 


128 


11 


66 


192 


12 


67 


1 


13 


67 


64 


14 


67 


128 


15 


67 


192 


16 


68 


2 


17 


68 


64 


18 


68 


128 


19 


68 


192 


20 


69 


2 


21 


69 


64 


22 


69 


128 


23 


69 


192 


* 


* 


* 


* 


* 




* 


* 




* 


* 


* 


48 


76 


0 


49 


76 


64 


50 


76 


128 


51 


76 


192 



Value Added 



diwy is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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diayout 



display hard disk partition, division, and size informa- 
tion 

Syntax 



/altos/bin/dlayout [-hpds] [part num] [device] 

Description 



The diayout utility displays the following hard disk configfuration in- 
formation: 

Partition 

(as configured with fdisk(ADM)) Displays parition number, active 
ststus, operating system type, start offset (in 512-byte blocks from 
the beginning of the hard disk), partition size (also in 512-byte 
blocks), and reserved area size. 

Division 

(as configured with dtvv>'(ADM)) Displays partition number, divi- 
sion number, start oflfset (in 1024-byte blocks after the reserved 
area, whihch is located at the beginning of the partition), and divi- 
sion size (in 1024-byte blocks). 

Disk Size 

Displays raw disk capacity (in megabytes), number of cylinders, 
number of heads, and number of sectors per track. 

The part num (partition number) parameter can be used to restrict the 
display of information to the specified partition only. A valid partition 
number is any single digit between 1 and 4, or 5 for the current active 
partition. 

The device paramter is used to specify which hard disk to display. 
The device should be a "whole-disk" physical device name (i.e., in 
the form /dev/rhd[a-z,A-Z]0). Do not use a division-level physical 
device name, such as /dev/rhdalO. If device is not specified, then 
/dev/rhdaO is assumed. 

Options 



-h Suppress title headers. 
March 3, 1991 
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-p Display partition information only, 
-d Display division information only, 
-s Display disk size information only. 

Note 

On a SCSI hard disk, the displayed number of cylinders, heads, and 
sectors per track are computed using a special algorithm, and does not 
always reflect the actual hardware configuration. 

See Also 

divvy(ADM), fdisk(ADM), hd(HW), mkdev(ADM) 

Value Added 

dlayout (ADM) is an extension of AT&T System V provided in Altos 
UNIX System V. 
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dlvr audit 



produce audit records for subsystem events 
Syntax 



dlvr_audit [ -v ] tstamp event record pid cmd code [ args ... ] 

Description 



dlvr audit is used by programs implementing protected subsystems as 
the means for sending audit records to the audit subsystem. Because 
those programs do not have the writeaudit privilege, they invoke 
dlvr audit which sends the data over a message queue to the audit 
daemon, which appends the record to the audit trail. Because 
dlvr audit is run as a child process of the process producing the 
record, it does not have the ability to write the audit device either. 
The message queue that it uses is only usable by the audit user, so 
dlvr audit must be run SUID to the audit user. The group is inherited 
from the invoking process and is checked against those groups associ- 
ated with protected subsystems. If the group cannot be identified with 
a protected subsystem, the record is ignored (so that general user pro- 
grams cannot flood the audit subsystem with invalid messages). 

The -V flag forces the program to report all of its actions. Normally, 
this flag is not used so that audit records can be made without the 
knowledge of the program user. 

The required arguments apply to all audit records. The tstamp argu- 
ment is the (ASCII number representation of the) time in seconds past 
Jan 1, 1970 that the audit record was produced. The event argument is 
the number of the event type as described in <sys/audit.h>. Similarly, 
the record argument is the audit record format type as described in 
<sys/audit.h>. The pid is the process ID of the event process. Cmd is 
the name of the protected subsystem command. Code is specific to 
the event type being generated. 

There may be 0 or more optional arguments depending on the code. 
dlvr audit uses the extra arguments to fill in specific fields required 
by the particular record format. 

See Also 



authaudit(S), audit(HW), "Maintaining System Security," chapter of 
the System Administrator's Guide 
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Value Added 

dlvr audit is an extension of AT&T System V provided in Altos UNIX 
System V. 
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dmesg 



displays the system messages on the console 
Syntax 



dmesg [ - ] 

Description 



The dmesg command displays all the system messages that have been 
generated since the last time the system was booted. If the option — 
is specified, it displays only those messages that have been generated 
since the last time the dmesg command was performed. 

dmesg can be invoked periodically by placing instructions in the file 
/usr/lib/crontab . It can also be invoked automatically by the /etc/rc2 
scripts whenever the system is booted. See "Notes", below. 

dmesg logs all error messages it prints in /usr/adm/messages. If 
dmesg is invoked automatically, the messages file continues to grow 
and can become very large. The system administrator should occa- 
sionally erase its contents. 

Files 



/etc/dmesg 

/usr/adm/messages 

/usr/adm/msgbuf 

Notes 



dmesg is included in this release for backwards compatibility only. 
The device /dev/error provides a more flexible means of logging error 
messages, and is recommended over dmesg. See error (M) for more 
information. 

See Also 



cron(C), error(M), messages(M) 

dmesg was developed at the University of California, Berkeley, and is 
used with permission. 
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Value Added 

dmesg is an extension of AT&T System V provided in Altos UNIX 
System V. 

I 
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dparam 



displays/changes hard disk characteristics 
Syntax 



dparam [ -w ] 

dparam /dev/rhd[OI 1]0 [characteristics] 

Description 



The dparam command displays or changes the hard disk characteris- 
tics currently in effect. These changes go into effect immediately and 
are also written to the master boot block for subsequent boots. If a 
non-standard hard disk is used, this utility must be called before 
accessing the drive. 

-w Causes a copy of /etc/masterboot to be copied to disk to 
ensure that non-standard hard disks are supported for the 
specified drive. This call must precede a call to write non- 
standard disk parameters for the desired parameters to be 
saved correctly in the masterboot block. 

When called without options or disk characteristics, dparam prints the 
current disk characteristics (on the standard output) for the specified 
hard disk. These values are printed in the same order as the argument 
list. 

When writing characteristics for the specified hard disk, dparam 
changes the current disk controller status and updates the masterboot 
block. The argument ordering is critical and must be entered as 
specified below. All characteristics must be entered when writing 
disk characteristics, otherwise an error is returned. Hard disk charac- 
teristics (in respective order) are: 

number of cylinders 

total number of cylinders on the hard disk 

number of heads 

number of heads 

write cylinder 

hardware specific, consult your hardware manual 

write precompensation cylinder 

hardware specific, consult your hardware manual 

ecc number of bits of error correction on I/O transfers. 
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consult your hardware manual 

control very hardware specific, consult your hardware manual 

landing zone cylinder 

where to park heads after shutting down the system 

number of sectors per track 

number of sectors per track on the hard disk 

Examples 

dparam -w 
dparam /dev/rhdlO 

dparam /dev/rhdOO 700 4 256 180 5 0 640 17 

Notes 

This utility changes the kernel's view of the hard disk parameters. It 
may be subject to restrictions imposed by the hardware configuration. 

Value Added 

dparam is an extension of AT&T System V provided in Altos UNIX 
System V. 
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fdisk 



maintain disk partitions 
Syntax 



fdisk [ [-p] [-ad partition] [-c partition start size] [-f devicename] ] 

Description 



fdisk displays information about disk partitions, fdisk also creates and 
deletes disk partitions and changes the active partition, fdisk func- 
tionality is a superset of the MS-DOS command of the same name. 
fdisk is usually used interactively from a menu. 

The hard disk has at most four partitions. Only one partition is active 
at any given time. It is possible to assign a different operating system 
to each partition. Once a partition is made active, the operating sys- 
tem resident in that partition boots automatically once the current op- 
erating system is halted. 

The fdisk utility reports disk sizes in tracks. The number of tracks 
available on a hard disk is equal to the number of heads times the 
number of cylinders. The, fdisk utility does not allocate the first track 
or the last cylinder on the hard disk when the "Use Entire Disk for 
UNIX" option is used. The first track on the hard disk is reserved for 
masterboot and the last cylinder is generally used when running hard 
disk diagnostics. You should not allocate the last cylinder if you plan 
to run diagnostics on your hard disk. 

For example, if a disk has 4 heads and 615 cylinders, it has 2460 
tracks, which fdisk reports as tracks 0-2459, If you choose the "Use 
Entire Disk for UNIX" option, fdisk will create a UNIX partition on 
tracks 1-2455. Track 0 is reserved for masterboot, and the last 
cylinder (tracks 2455-2459) is not assigned with the "Use Entire Disk 
for UNIX" option. 

Partitions are defined by a "partition table" at the end of the master 
boot block. The partition table provides the location and size of the 
partitions on the disk. The partition table also defines the active parti- 
tion. Each partition can be assigned to UNIX, DOS, or some other op- 
erating system. Once a DOS partition is set up, DOS files and direc- 
tories resident in the DOS partition may be accessed while from the 
UNIX partition by means of the dos(C) commands. DOS may be 
booted without the DOS partition being active by entering "dos" at 
the boot prompt. See boot(HW). 
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FDISK (ADM) 



-p, -a, -d, -c 

These flags are used to invoke fdisk non-interactively. The argu- 
ment number, below, refers to a valid partition number (1-4). 

-p Prints out the disk partition table, one partition to a line. For each 
partition, fdisk displays the following information: partition start 
stop size status type. 

-a number 

Activates partition number. 

-d number 

Deletes partition number. 

-c number start size 

Creates a partition, number, size tracks long beginning at track 
start. The -c option is used to use the entire disk for UNIX; the 
appending of a dash to the end of the command line accomplishes 
this, as in the following example: 

fdisk -c 1 1 - 

This syntax is used only during installation. If there are any existing 
partitions on the disk, this command will fail. 

-f name 

Open device name and read the partition table associated with that 
device's partition. The default is /dev/rhdaO. 

Options 



When invoked interactively (without the -p, -a, -d, or -c options), fdisk 
displays a prompt and a menu of five options. 

1 . Display Partition Table. 

This option displays a table of information about each partition on 
the hard disk. The PARTITION column gives the partition num- 
ber. The STATUS column tells whether the partition is active (A) 
or inactive (I). TYPE tells whether the partition is a UNIX parti- 
tion, a DOS partition, or "other". The option also displays the 
starting track, ending track and total number of tracks in each par- 
tition. 

2. Use Entire Disk for UNIX. 

fdisk creates one partition that includes all the tracks on the disk, 
except the first track and the last cylinder. This partition is 
assigned to the UNIX system and is designated the active partition. 
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3. Use Rest of Disk for UNIX. 

fdisk creates one partition that occupies the remainder of the disk. 
This partition is assigned to UNIX and is designated the active par- 
tition. 

4. Create UNIX Partition 

This option allows the creation of a partition by altering the parti- 
tion table, fdisk reports the number of tracks available for each 
partition and the number of tracks in use. fdisk prompts for the 
partition to create, the starting track and size in tracks. 

5. Activate Partition 

This option activates the specified partition. Only one partition 
may be active at a time. The operating system residing in the 
newly activated partition boots once the current operating system 
is halted. 

6. Delete Partition 

This option requests which partition you wish to delete, fdisk 
reports the new available amount of disk space in tracks. 

Exit the fdisk program by typing a 'q' at the msin fdisk menu. 

Notes 



The minimum recommended size for a UNIX partition is 50 mega- 
bytes. 

Since fdisk is intended for use with DOS, it may not work with all op- 
erating system combinations. 

See Also 



dos(C), hd(HW) 

Value Added 



fdisk is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 



March 19, 1991 



FDISK-3 



FDSWAP (ADM) 



FDSWAP (ADM) 



fdswap 

swaps default boot floppy drive 
Syntax 



fdswap [onloff] 

Description 



fdswap tells the CMOS to swap the default floppy drive used to read 
boot information at boot time. For example, if your computer defaults 
to read boot information on drive A, fdswap on changes the default 
drive to drive B. 



fdswap with no arguments reports the current fdswap state, on or off. 
fdswap oj^ switches the drive setting back to the default configuration. 
Changing the drives take effect on the next boot of the system. 



Notes 



Support for this functionality is only available on a small number of 
machines. The ROMs must recognize and interpret the CMOS flag 
that specifies that the floppy drives are swapped. 
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ff 



list file names and statistics for a filesystem 
Syntax 



/etc/ff [options] special 

Description 



The ff command reads the i-list and directories of the special file, 
assuming it is a file system. Inode data is saved for files which match 
the selection criteria. Output consists of the path name for each saved 
inode, plus other file information requested using the print options 
below. Output fields are positional. The output is produced in inode 
order; fields are separated by tabs. The default line produced byjQ^is: 

path-name i-number 

With all options enabled, output fields would be: 

path-name i-number size uid 

The argument n in the option descriptions that follow is used as a 
decimal integer (optionally signed), where +« means more than n, -n 
means less than n, and n means exactly n. A day is defined as a 24- 
hour period. 



-I Do not print the inode number after each path name. 

-1 Generate a supplementary list of all path names for 

multiple-linked files. 

-p prefix The specified prefix will be added to each generated 
path name. The default is . (dot). 

-s Print the file size, in bytes, after each path name. 

-u Print the owner's login name after each path name. 

-a n Select if the inode has been accessed in n days. 

-m n Select if the inode has been modified in n days. 

-c n Select if the inode has been changed in n days. 
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-n file 



Select if the inode has been modified more recently 
than the argument file . 



■i inode-list Generate names for only those inodes specified in 



See Also 



find(C), ncheck(ADM) 

Notes 



If the -1 option is not specified, only a single path name out of all pos- 
sible ones is generated for a multiple-linked inode. If -1 is specified, all 
possible names for every linked file on the file system are included in 
the output. However, no selection criteria apply to the names gen- 
erated. 

This command only works on UNIX filesystems. 



inode-list . 
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fixperm 



correct or initialize file permissions and ownership 
Syntax 



fixperm [ -cfgilnpsvwDS [ -d package] ] specfile 

Description 



For each line in the specification file specfile, fixperm makes the 
listed pathname conform to a specification, fixperm is typically used 
to configure a UNIX system upon installation. It can only be invoked 
by a superuser, and it only works from the root directory. If it is 
invoked fi-om any other directory, incorrect results will be returned. 

The specification file has the following format: Each non-blank line 
consists of either a comment or an item specification. A comment is 
any text fi"om a pound sign "#" up to the end of the line. There is one 
item specification per line. User and group id numbers must be speci- 
fied at the top of the specification file for each user and group men- 
tioned in the file. The syntax for the definition section is simple: the 
first field indicates the type of id (either uid or gid), the second con- 
tains the name reference for the id, and the third is the corresponding 
numeric id. Example: 

uid root 0 

An item specification consists of a package specifier, a permission 
specification, owner and group specifications, the number of links on 
the file, the file name, and an optional volume number. 

The package specifier is an arbitrary string which is the name of a 
package within a distribution set. A package is a set of files. 

After the package specifier is a permission specification. The permis- 
sion specification consists of a file type, followed by a numeric per- 
mission specification. The item specification is one of the following 
characters: 

X Executable. 

a Archive. 

e Empty file (create if -c option given). 
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b Block device, 
c Character device, 
d Directory, 
f Text file, 
p Named pipe. 

0 OK. It indicates to fixperm that there should be no file type 
checking allowing any format or contents in what would nor- 
mally be the header section of an executable. For example, data 
files and encrypted files should be of type "o". 

If the item specification is used as an upper-case letter, then the file 
associated with it is optional, and fixperm will not return an error mes- 
sage if it does not exist. 

The numeric permission conforms to the scheme described in 
chmodiC). The owner and group permissions are in the third column 
separated by a slash: e.g.,: "bin/bin". The fourth column indicates the 
number of links. If there are links to the file, the next line contains the 
linked filename with no other information. The fifth column is a path- 
name. The pathname must be relative, i.e., not preceded by a slash 
'7". The sixth column is only used for special files, giving the major 
and minor device numbers, or volume numbers. 

Options 



The following options are available from the command line, unless 
otherwise noted: 

-c Create empty files and missing directories. Also or creates (or 
modifies) device files. 

-g Instructs fixperm to list devices as specified in the permlist (similar 
to the -f flag, which lists files on standard output). No changes are 
made as a result of this flag. 

-d package 

Process input lines beginning with given package specifier string 
(see above). For instance, -dBASE processes only items specified 
as belonging to the Basic utilities set. The default action is to pro- 
cess all lines. 

-u package 

Like -u, but processes items that are not part of the given package. 
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-f List files only on standard output. Does not modify target files, 
-i (Available from a program or shell script only) 

Check only if the selected packages are installed. Return values 



-1 List files and directories on standard output. Does not modify tar- 
get files. 

-n Report errors only. Does not modify target files. 

-p Override default uid/gid found in /etc/passwd and /etc/group with 
the value found in the permlist. Because UNIX and XENIX have 
different values for certain uid and gids (for example, in UNIX 
bin=2, and XENIX bin=3) the default value is gleaned from the 
/etc/passwd and /etc/group files. This option forces the values to 
be taken from the perms list. It also generates a warning if the 
permlist doesn't /etc/passwd and /etc/group. 

-D List directories only on standard output. Does not modify target 
files. 

-V Verbose, in particular, issues a complaint if executable files are 
word swapped, not fixed stack, not separate I and D, or not 
stripped. 

-s Modify special device files in addition to the rest of the permlist. 

-w Lists where (what volume) the specified files or directories are 
located. 

-S Issues a complaint if files are not in x.out format. 

The following two lines make a distribution and invoke tar(C) to 
archive only the files in perms.inst on /dev/sample: 



are: 



0: 
4: 
5: 



package completely installed 
package not installed 
package partially installed 



/etc/fixperm -f /etc/perms/inst > list 
tar cfF /dev/sample list 



This example reports BASE package errors: 



/etc/fixperm -nd BASE /etc/perms/* 



or 



/etc/fixperm -nd BASE /etc/peims/filename 
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Usually fixperm is only run by a shell script at installation. 

See Also 



custom (ADM) 

Value Added 



fixperm is an extension of AT&T System V provided in Altos UNIX 
System V. 
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fsave 



interactive, error-checking filesystem backup 
Synopsis 



fsave filesystem [ backupinfo ] [ mediainfo ] [ sitename ] 

Description 



fsave is used by fsphoto{k\yM) to provide a semi-automated interface 
to xbackup{ADy() and cpio(C) for backing-up filesystems. Human 
intervention is required to mount and dismount tapes or floppies at the 
appropriate times, but is kept to a minimum to reduce the potential for 
error. 

The operator is prompted each time some action is required, such as 
mounting or unmounting a tape or floppy. These prompts, and their 
possible selections, are described below. 

For all prompts, an answer of h, H, or ? will display a short summary 
of the possible answers. 

Filesystem dump (backup) 

The following prompt displays the defaults (gleaned from the sched- 
ule database file) and presents options to alter them: 

Level dumplevel dunp of filesystem filesystem , date 

media size: size feet [or Kb] 

media drive: drive 
This mei^a will be saved for howlong, and is howvital. 

M)ovinted volijme, P)ostpone, C)heck or F)oniat volumes, R) Betension or H)elp: 

The values displayed dictate the following instructions: filesystem is 
to be backed-up using size -foot long magtapes (or j'lVe -kilobyte big 
floppies) mounted on drive drive . TTie media will be saved for how- 
long ("1 year," "2 months," etc.), and being a level dumplevel dump, 
is howvital ("critical," "precautionary," etc.). 

The menu options are: 

m A volume of the asked for size has been mounted (write- 

enabled), so begin the dump. 

mnewsize Insufficient volumes of the originally asked for size are 
available, so a newsize big volume has been mounted 
instead. If the dump extends across more than one volume, 
each volume must be of the same size . 
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p Postpone this backup until later (fsphoto will automatically 

retry this filesystem next time it is run). 

c Recheck the volumes used to backup filesystem for errors. 

This answer is useful when a dump mysteriously fails and 
fsave is starting over from the beginning, but the operator 
doesn't believe there really is a problem (for example, the 
tape drive was accidentally left offline or the floppy door 
was left open), and wants to check the volumes again. 

f Format the currently mounted volume (useful mainly for 

floppies). 

r Retension cartridge tape using /usr/bin/tape. 

If multiple volumes are required, backup will pause for the next vol- 
ume to be mounted. Be certain to keep track of the volume order. 

Format check 

The format of "critical' ' volumes are checked using dumpdir(ADM): 

Check vital voltmnes for format errors 

M)oiinted first volijitie, S)kip foritat check, or H)elp: 

The menu options are: 

m The first volume has been (or still is) mounted, and dump- 

dir can now check the volume format. 

s Skip checking the volume format, and continue on to the 

read error check (below). 

The format is not always checked, but when it is, the first volume writ- 
ten must be mounted. 

Read error check 

All volumes created using xbackupihDM) are read using 
xrestorei^ADM), which checks for errors during reading. If an error 
occurs, die dump is declared unsuccessful and is retried from the 
beginning. 

Check vital volumss for read errors 

M)ounted which volume, E)rror cx\ previous volume, D)Qne, S)kip checks, or H)elp: 

The menu options are: 

m The which ("first" or "next") volume has been mounted 

on the drive and is ready to be checked for read errors. 
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e An error occurred on the last volume checked, and the 

dump should be retried. 

d All volumes have been checked and no errors occurred, so 

the filesystem has been successfully backed-up; This 
backup is done. 

s Don't bother (skip) checking the rest of the volumes for 

read errors. 

Every volume should be checked for read errors; xrestore requires the 
volumes to be checked in first-to-last order. Volumes that produce 
read errors should be marked "suspect," discarded and the dump run 
once again. 

After the backup has been successfully performed, instructions are 
given on how to label the volumes. 

Arguments 

fsave is normally run by fsphoto , which passes all the proper argu- 
ments based on the schedule (ADM) database. 

filesystem 

The filesystem to be backed-up. 

dumpinfo 

A set of blank-separated strings that give some optional informa- 
tion about this backup: 

dumplevel size savetime importance marker 

Each of these component strings may be quoted and can thus con- 
tain spaces. 

dumplevel The level of the dump to be performed. This is a single 
digit from 0 to 9 (passed to dump), or the letter x (which 
means no dump is to be done). The default is to per- 
form a level 0 dump. 

size The size of the media volumes that should be used. 

This should be in feet for tapes and kilobytes for 
floppies. A size of - means to use the first size listed in 
mediainfo . This is the default. 

savetime How long this backup is to be saved (for example, "3 
months"). Default is "1 year." 

importance 

How important is this backup? (For example, "criti- 
cal" or "precautionary.") Those which are "critical" 
have their format checked by dumpdir. Default is 
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"important." 

marker Either "none" (the default) or an additional label to 
place on each volume (for example, "a pink sticker"). 

A typical dumpinfo might look like: 

9 1200 "2 weeks" useful "a blue X" 

which specifies that a level 9 dump is to be done on a 1200 foot 
tape (or 1200 kilobyte floppy) which will be saved for 2 weeks and 
is to be marked with a blue cross (in addition to a more descriptive 
label). This backup is merely considered "useful" and thus will 
not be checked by dumpdir. 

mediainfo 

A set of blank-separated strings that give some optional informa- 
tion about this the media to be used: 

drive d density sizes... [format] 
drive k sizes ... [format] 

drive The name of backup device to use. The default is 

IdevlrmtO. 

k sizes... If k is specified, drive is assumed to be a floppy, and 
the list of sizes which follow define the allowable 
capacities of the floppies that can be used (in kilo- 
bytes). 

d density sizes... 

Otherwise, d must be specified. In this case, drive is 
assumed to be a magtape at density BPI , in one of 
the possible sizes (in feet). 

format The UNIX command used to format the tape or 

floppy so described. 

A mediainfo describing 9-track magtape would be: 

media /dev/rmtO d 1600 2400 1200 600 
media /dev/rmt2 d 800 1400 1200 600 

which specifies that IdevlrmtO is a 1600 BPI magtape capable of 
handling 2400, 1200, and 600 foot reels, and that Idevlrmtl is the 
800 BPI device. 

A floppy might be described with: 

media /dev/fdO k 1024 format /dev/fdO 
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which describes device IdevlfdO as a megabyte (1024 kilobytes) 
floppy formatted by the command: 

format /dev/fdO 

sitename 

Where this backup was made (for example, the name of the com- 
pany or which building). Note that the uucpiC) nodename from 
letclsystemid is automatically placed on the volume labels. 

Only the super-user can execute the/^ave command. 

Files 



/etc/systemid 

Name of this machine. 

/etc/ddate 

Z>ac^Mp -maintained record of last time each filesystem was 
backed-up. 

/dev/tty 

Always-existent character- special device. 

See Also 



fsphoto(ADM), schedule(ADM), xbackup(ADM), dumpdir(ADM), 
xrestore(ADM), cpio(C), basename(C) 

Diagnostics 



A successful backup exits successfully (0), but errors generate a com- 
plaint and an exit status of 1. fsave complains about illegal or 
incorrect arguments, and exits with a status of 2. 

If the backup of filesystem is postponed, /^ave exits with a status of 3. 

Value Added 



fsave is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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checks and repairs filesystems 
Syntax 



/etc/fsck [ options ] [ filesystem ] ... 

/etc/dfsck optionsl] filesysl ... -[options!] filesys2 ... 

Description 



fsck audits and interactively repairs inconsistent conditions for all 
supported filesystems. If the filesystem is consistent, the the number 
of files, number of blocks used, and number of blocks free are 
reported. If the filesystem is inconsistent, the operator is prompted for 
concurrence before each correction is attempted. It should be noted 
that most corrective actions result in some loss of data. The amount 
and severity of the loss may be determined from the diagnostic output. 
(An experienced operator can resolve discrepancies manually using 
fsdb(ADM), the filesystem debugger.) The default action for each 
consistency correction is to wait for the operator to respond "yes" or 
"no". If the operator does not have write permission /^c^ defaults to 
the action of the -n option. 

The following flags are interpreted by fsck: 

-C[clustersize] 

Converts the named S51K filesystem into an AFS (Acer Fast 
Filesystem). The -s option must also be present. The cluster - 
size argument must be a power of 2 and less than 16 (8 is the 
recommended value). The increase in speed that is possible 
with a fast filesystem will not be immediately apparent; it will 
take affect only with the new files added to the filesystem. 
There is little or no benefit in transforming a filesystem that is 
nearly full; if it is within a few blocks of being full, the conver- 
sion will not work. (This option can only be used to convert an 
S51K fileystem.) 

-y Assumes a yes response to all questions asked by fsck. 

-n Assumes a no response to all questions asked by fsck ; do not 
open the filesystem for writing. 

-sb:c Ignores the actual free list and (unconditionally) reconstructs a 
new one by rewriting the super-block of the filesystem. The 
filesystem must be unmounted while this is done. 
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The -sb:c option allows for creating an optimal free-list organ- 
ization. The following forms are supported: 

-s 

-sBlocks-per-cylinder:Blocks-to-skip (filesystem interleave) 
(for anything else) 

If b:c is not given, then the values used when the filesystem 
was created are used. If these values were not specified, then a 
reasonable default value is used. 

-S Conditionally reconstructs the free list. This option is like - 
sb:c above except that the free list is rebuilt only if there are 
no discrepancies discovered in the filesystem. Using -S forces 
a "no" response to all questions asked by fsck. This option is 
useful for forcing free list reorganization on uncontaminated 
filesystems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses 
a scratch file. If the -t option is specified, the file named in the 
next argument is used as the scratch file, if needed. Make cer- 
tain you leave a space between the -t and the filename, or fsck 
will use the entire filesystem as a scratch file and erase the 
entire disk. If you created a scratch filesystem during installa- 
tion then you can use /dev/scratch as the filename, provided 
that the filesystem being checked is no larger than the root 
filesystem. Without the -t flag, fsck prompts the operator for 
the name of the scratch file. The file chosen should not be on 
the filesystem being checked, and if it is not a special file or 
did not akeady exist, it is removed when fsck completes. If the 
system has a large hard disk there may not be enough space on 
another filesystem for the scratch file. In such cases, if the sys- 
tem has a floppy drive, use a blank, formatted floppy in the 
floppy drive with (for example) /dev/fdO specified as the 
scratch file. 

-q Quiet fsck. Do not print size-check messages in Phase 1. 
Unreferenced fifoS files will selectively be removed. If fsck 
requires it, counts in the superblock will be automatically fixed 
and the free list salvaged. 

-D Directories are checked for bad blocks. Useful after system 
crashes. 

-f Fast check. Check block and sizes (Phase 1) and check the 
free list (Phase 5). The free list will be reconstructed (Phase 6) 
if it is necessary. 

-b Recovers a UNIX root filesystem. The required filesystem 
argument must refer to the root filesystem, and preferably to 
the block device (normally /dev/root). This switch implies -y 
and overrides -n . If any modifications to the filesystem are 
required, the filesystem will be automatically mounted. 
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-rr Recover XENIX root filesystem. Equivanlent to the -b option 
described above for UNIX root filesystem recovery. 

-c Causes any supported filesystem to be converted to the type of 
the current filesystem. The user is prompted to verify the 
request for each filesystem that requires conversion unless the 
-y option is specified. It is recommended that every filesystem 
be checked with this option while unmounted. To update the 
active root filesystem, it should be checked with: 

fsck -c -rr /dev/root 

If no filesy stems are specified, /jcyt reads a list of default filesystems 
from the file /etc/checklist. 

Inconsistencies checked are as follows: 

• Blocks claimed by more than one inode or the free list 

• Blocks claimed by an inode or the free Ust outside the range of 
the filesystem 

• Incorrect link counts 

• Size checks: 

Incorrect number of blocks 
Directory size not 16-byte aligned 

• Bad inode format 

• Blocks not accounted for anywhere 

• Directory checks: 

File pointing to unallocated inode 
Inode number out of range 

• Super block checks: 
More than 65536 inodes 

More blocks for inodes than there are in the filesystem 

• Bad free block list format 

• Total free block or free inode count incorrect 

Orphaned files and directories (allocated but unreferenced) are, with 
the operator's concurrence, reconnected by placing them in the 
lost+found directory. The name assigned is the inode number. The 
only restriction is that the directory lost+found must preexist in the 
root of the filesystem being checked and must have empty slots in 
which entries can be made. This is accomplished by making 
lost+found, copying a number of files to the directory, and then 
removing them (before fsck is executed). 
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dfsck allows two filesystem checks on two dififerent drives simultane- 
ously. Optionsl and options! are used to pass options to fsck for the 
two sets of filesystems. A - is the separator between filesystem 
groups. 

The dfsck program permits an operator to interact with two fsck pro- 
grams at once. To help in this, dfsck displays the filesystem name for 
each message to the operator. When answering a question from dfsck, 
the operator must preface the response with a 1 or a 2 (indicating that 
the answer refers to the first or second filesystem group). 

Do not use dfsck to check the root filesystem. 

Files 



/etc/checklist Contains default list of filesystems to check 
/etc/defaultA)Oot Automatic boot control 

See Also 



autoboot(ADM), fsdb(ADM), checklist(F), filesystem(F), init(M) 

Notes 



The directory /etc/fscmd.d/7YP£ contains programs for each file sys- 
tem type; each of these programs applies some appropriate heuristic to 
determine whether the supplied special file is of the type for which it 
checks. 

fsck will not run on a mounted non-raw filesystem unless the filesys- 
tem is the root filesystem or unless the -n option is specified and no 
writing out of the filesystem will take place. If any such attempt is 
made, a warning is displayed and no further processing of the filesys- 
tem is done for the specified device. 

Although checking a raw device is almost always faster, there is no 
way to tell if the filesystem is mounted. And cleaning a mounted 
filesystem will almost certainly result in an inconsistent superblock. 

Warning 



Filesystems created under UNIX-86 version 3.0 are not supported 
under UNIX System V/386 3.2 because the word ordering in type long 
variables has changed, fsck is capable of auditing and repairing UNIX 
version 3.0 file systems if the word ordering is correct. 

For the root filesystem, "fsck -rr /dev/root" should be run. For all 
other filesystems, "fsck /dev/??" on the unmounted block device 
should be used. 
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Initialization Phase 



Command syntax is checked. Before the filesystem check can be per- 
formed, fsck sets up certain tables and opens some files. The fsck ter- 
minates on initialization errors. 

General Errors 



Three error messages may appear in any phase. While they seem to 
offer the option to continue, it is generally best to regard them as fatal, 
end the run, and investigate what may have caused the problem. 

CAN NOT SEEK: BLK B (CONTINUE?) 

The request to move to a specified block number B in the 
filesystem failed. The occurrence of this error condition 
indicates a serious problem (probably a hardware failure) 
that may require additional help. 

CAN NOT READ: BLK B (CONTINUE?) 

The request for reading a specified block number B in the 
filesystem failed. The occurrence of this error condition 
indicates a serious problem (probably a hardware failure) 
that may require additional help. 

CAN NOT WRITE: BLK B (CONTINUE?) 

The request for writing a specified block number B in the 
filesystem failed. The disk may be write-protected. 



Meaning of Yes/No Responses 



Prompt 


n(no) 


y(yes) 


CONTINUE? 


Terminates program. 
(This is the recom- 
mended response.) 


Attempts to continue to 
run filesystem check. 
Often, however, the 
problem persists. The 
error condition does not 
allow a complete check 
of the filesystem. A 
second run of fsck 
should be made to 
recheck this filesystem. 
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This phase checks the inode list. 



Meaning of Yes/No Responses — Phase 1 



Prompt 


n(no) 


y(yes) 


CONTINUE? 


Terminates the pro- 
gram. 

(Recommended 
response.) 


Continues with the pro- 
gram. 

This error condition 
means that a complete 
check of the filesystem 
is not possible. A 
second run of fsck 
should be made to 
recheck this filesystem. 


CLEAR? 


Ignores the error condi- 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Deallocates i-node / by 
zeroing its contents. 
This may invoke the 
UNALLOCATED error 
condition in Phase 2 for 
each directory entry 
pointing to this i-node. 



Phase 1 Error Messages 

UNKNOWN FILE TYPE 1=1 (CLEAR?) 

The mode word of the i-node / suggests that the i-node is not 
a pipe, special character i-node, regular i-node, or directory 
i-node. 

LINK COUNT TABLE OVERFLOW (CONTINUE?) 

An internal table for fsck containing allocated i-nodes with a 
link count of zero has no more room. 

B BAD 1=1 

I-node / contains block number B with a number lower than 
the number of the first data block in the filesystem or greater 
than the number of the last block in the filesystem. This 
error condition may invoke the EXCESSIVE BAD BLKS 
error condition in Phase 1 if i-node / has too many block 
numbers outside the filesystem range. This error condition 
invokes the BAD/DUP error condition in Phase 2 and Phase 
4. 

EXCESSIVE BAD BLOCKS 1=1 (CONTINUE?) 

There is more than a tolerable number (usually 10) of blocks 
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with a number lower than the nunnber of the first data block 
in the filesystem or greater than the number of the last block 
in the filesystem associated with i-node /. 

B DUP 1=1 

I-node / contains block number fi, which is already claimed 
by another i-node. This error condition may invoke the 
EXCESSIVE DUP BLKS error condition in Phase 1 if 
i-node / has too many block numbers claimed by other 
i-nodes. This error condition invokes Phase IB and the 
BAD/DUP error condition in Phase 2 and Phase 4. 

EXCESSIVE DUP BLKS 1=1 (CONTINUE?) 

There is more than a tolerable number (usually 10) of blocks 
claimed by other i-nodes. 

DUP TABLE OVERFLOW (CONTINUE?) 

An internal table in fsck containing duplicate block numbers 
has no more room. 

POSSIBLE FILE SIZE ERROR 1=1 

The i-node / size does not match the actual number of blocks 
used by the i-node. This is only a warning. If the -q option 
is used, this message is not printed. 

DIRECTORY MISALIGNED 1=1 

The size of a directory i-node is not a multiple of 16. This is 
only a warning. If the -q option is used, this message is not 
printed. 

PARTIALLY ALLOCATED INODE 1=1 (CLEAR?) 
I-node / is neither allocated nor unallocated. 

Phase IB: Rescan for More DUPS 



When a duplicate block is found in the filesystem, the filesystem is 
rescanned to find the i-node that previously claimed that block. When 
the duplicate block is found, the following information message is 
printed: 

B DUP 1=1 

I-node / contains block number B, which is already claimed 
by another i-node. This error condition invokes the 
BAD/DUP error condition in Phase 2. I-nodes with overlap- 
ping blocks may be determined by examining this error con- 
dition and the DUP error condition in Phase 1 . 
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This phase removes directory entires pointing to bad inodes found in 
Phase 1 and phase IB. 



Meaning of Yes/No Responses— Phase 2 



Prompt 


n(no) 


y(yes) 


HX? 


Terminates the program 
since fsck will be 
unable to continue. 


In Phase 2, a y(yes) 
response to the HX? 
prompt says: Change 
the root i-node type to 
"directory." 
If the root i-node data 
blocks are not directory 
blocks, a very large 
number of error condi- 
tions are produced. 


CONTINUE? 


Terminates the pro- 
gram. 


Ignores DUPS/BAD 
error condition in root 
i-node and attempt to 
continue to run the 
filesystem check. 

11 1 UUl 1 IIUUC 12> llUi 

correct, then this may 
result in a large number 
of other error condi- 
tions. 


REMOVE? 


Ignores the error condi- 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Removes duplicate or 
unallocated blocks. 



Phase 2 Error Messages 

ROOT INODE UNALLOCATED. TERMINATING 

The root i-node (always i-node number 2) has no allocate 
mode bits. The occurrence of this error condition indicates a 
serious problem. The program stops. 
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ROOT INODE NOT DIRECTORY (FIX?) 

The root i-node (usually i-node number 2) is not directory 
i-node type. 

DUPS/BAD IN ROOT INODE (CONTINUE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks in 
the root i-node (usually i-node number 2) for the filesystem. 

I OUT OF RANGE 1=1 NAME=F (REMOVE?) 

A directory entry F has an i-node number / that is greater 
than the end of the i-node list. 

UNALLOCATED 1=1 OWNER=0 MODE=M SIZE=S 

MTIME=T NAME=F (REMOVE?) 

A directory entry F has an i-node / without allocate mode 
bits. The owner O, mode M, size S, modify time T, and 
filename F are printed. If the filesystem is not mounted and 
the -n option was not specified, the entry is removed auto- 
matically if the i-node it points to is character size 0. 

DUP/BAD 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 

DIR=F (REMOVE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with directory entry F, directory i-node /. The 
owner O, mode M, size S, modify time T, and directory name 
F are printed. 

DUP/BAD 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 

FILE=F (REMOVE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with file entry F, i-node /. The owner O, mode M, 
size S, modify time T, and filename F are printed. 

BAD BLK B IN DIR 1=1 OWNER=0 MODE=M SIZE=S 
MTIME=T 

This message only occurs when the -D option is used. A bad 
block was found in DIR i-node /. Error conditions looked 
for in directory blocks are nonzero padded entries, incon- 
sistent "." and entries, and embedded slashes in the 
name field. This error message means that the user should at 
a later time either remove the directory i-node if the entire 
block looks bad or change (or remove) those directory 
entries that look bad. 

Phase 3: Check Connectivity 



This phase is concerned with the directory connectivity seen in Phase 
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Meaning of Yes/No Responses — Phase 3 



Prompt 


n(no) 


y(yes) 


RECONNECT? 


Ignores the error condi- 
tion. 

This invokes the 
UNREF error condition 
in Phase 4. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Reconnects directory 
i-node / to the filesys- 
tem in directory for lost 
files (usually 
lost+found). 
This may invoke a 
lost+found error condi- 
tion if there are prob- 
lems connecting direc- 
tory i-node / to 
lost+found. 

This invokes CON- 
NECTED information 
message if link was 
successful. 



Phase 3 Error Messages 

UNREF DIR 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 

(RECONNECT?) 

The directory i-node / was not connected to a directory entry 
when the filesystem was traversed. The owner O, mode M, 
size 5, and modify time T of directory i-node / are printed. 
The fsck program forces the reconnection of a nonempty 
directory. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the 
filesystem; fsck ignores the request to link a directory in 
lost+found. This invokes the UNREF error condition in 
Phase 4. Possible problem with access modes of lost+found. 

SORRY. NO SPACE IN Ibst+found DIRECTORY 

There is no space to add another entry to the lost+found 
directory in the root directory of the filesystem; fsck ignores 
the request to link a directory in lost+found. This invokes 
the UNREF error condition in Phase 4. Clean out unneces- 
sary entries in lost+found or make lost+found larger (see 
Procedure 5.2). 

DIR 1=11 CONNECTED. PARENT WAS 1=12 

This is an advisory message indicating a directory i-node II 
was successfully connected to the lost+found directory. The 
parent i-node 12 of the directory i-node II is replaced by the 
i-node number of the lost+found directory. 
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This phase checks the link count information seen in Phases 2 and 
3. 



Meaning of Yes/No Responses — Phase 4 



Prompt 


n(no) 


y(yes) 


RECONNECT? 


Ignores this error con- 
dition. 

This invokes a CLEAR 
error condition later in 
Phase 4. 


Reconnect i-node / to 
filesystem in the direc- 
tory for lost files (usu- 
ally lost+found). 
This can cause a 
lost+found error condi- 
tion in this phase if 
there are problems con- 
necting i-node / to 
lost+found. 


CLEAR? 


Ignores the error condi- 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Deallocates the i-node 
by zeroing its contents. 


ADJUST? 


Ignores the error condi- 
tion. 

A XT/**\ . 1 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Replaces link count of 
file i-node / with Y. 


FIX? 


Ignores the error condi- 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Replaces count in 
super-block by actual 
count. 



Phase 4 Error Messages 

UNREF FILE 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 
(RECONNECT?) 
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I-node / was not connected to a directory entry when the 
filesystem was traversed. The owner (9, mode M, size 5, and 
modify time T of i-node / are printed. If the -n option is 
omitted and the filesystem is not mounted, empty files are 
cleared automatically. Nonempty files are not cleared. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the 
filesystem; fsck ignores the request to link a file in 
lost+found. This invokes the CLEAR error condition later 
in Phase 4. Possible problem with access modes of 
lost+found. 

SORRY. NO SPACE IN lost+found DIRECTORY 

There is no space to add another entry to the lost+found 
directory in the root directory of the filesystem; fsck ignores 
the request to link a file in lost+found. This invokes the 
CLEAR error condition later in Phase 4. Check size and 
contents of lost+found. 

(CLEAR) 

The i-node mentioned in the immediately previous UNREF 
error condition cannot be reconnected. 

LINK COUNT FILE 1=1 OWNER=0 MODE=M SIZE=S 
MTIME=T COUNT=X SHOULD BE Y (ADJUST?) 

The link count for i-node /, which is a file, is X but should be 
Y. The owner O, mode M, size S, and modify time T are 
printed. 

LINK COUNT DIR 1=1 OWNER=0 MODE=M SIZE=S 
MTIME=T COUNT=X SHOULD BE Y (ADJUST?) 

The link count for i-node /, which is a directory, is X but 
should be Y. The owner O, mode M, size S, and modify time 
T of directory i-node / are printed. 

LINK COUNT F 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 

COUNT=X SHOULD BE Y (ADJUST?) 

The link count for F i-node / is X but should be Y. The 
filename F, owner O, mode M, size S, and modify time T are 
printed. 

UNREF FILE 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 
(CLEAR?) 

I-node /, which is a file, was not connected to a directory 
entry when the filesystem was traversed. The owner O, 
mode M, size S, and modify time T of i-node / are printed. If 
the -n option is omitted and the filesystem is not mounted, 
empty files are cleared automatically. Nonempty directories 
are not cleared. 
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UNREF DIR 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 
(CLEAR?) 

I-node /, which is a directory, was not connected to a direc- 
tory entry when the filesystem was traversed. The owner O, 
mode M, size S, and modify time T of i-node / are printed. If 
the -n option is omitted and the filesystem is not mounted, 
empty directories are cleared automatically. Nonempty 
directories are not cleared. 

BAD/DUP FILE 1=1 OWNER=0 MODE=M SIZE=S MnME=T 
(CLEAR?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with file i-node /. The owner O, mode Af , size 5, 
and modify time T of i-node / are printed. 

BAD/DUP DIR 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 
(CLEAR?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with directory i-node /. The owner O, mode M, 
size S, and modify time T of i-node / are printed. 

FREE INODE COUNT WRONG IN SUPERBLK (HX?) 

The actual count of the free i-nodes does not match the 
count in the super-block of the filesystem. If the -q option is 
specified, the count will be fixed automatically in the super- 
block. 

Phase 5: Check Free List 



This phase checks the free-block list. 



Meaning of Yes/No Responses — Phase 5 



Prompt 


ii(no) 


y(yes) 


CONTINUE? 


Terminates the pro- 
gram. 


Ignores rest of the 
free-block list and con- 
tinue execution of fsck. 
This error condition 
will always invoke 
BAD BLKS IN FREE 
LIST error condition 
later in Phase 5. 



(Continued) 



March 19, 1991 



FSCK-13 



FSCK (ADM) 



FSCK(/^DM) 



Prompt 


n(no) 


y(yes) 


FIX? 


Ignores the error condi- 
tion. 

A NO Tp^nonQp nnlv 

appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Replaces count in 
super-block by actual 
count. 


SALVAGE? 


Ignores the error condi- 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 


Replaces actual free- 
block list with a new 
free-block list. 
The new free-block list 
will be ordered accord- 
ing to the gap and 
cylinder specs of the -s 
or -S option to reduce 
time spent waiting for 
the disk to rotate into 
position. 



Phase 5 Error Messages 

EXCESSIVE BAD BLKS IN FREE LIST (CONTINUE?) 

The free-block list contains more than a tolerable number 
(usually 10) of blocks with a value less than the first data 
block in the filesystem or greater than the last block in the 
filesystem. 

EXCESSIVE DUP BLKS IN FREE LIST (CONTINUE?) 

The free-block list contains more than a tolerable number 
(usually 10) of blocks claimed by i-nodes or earlier parts of 
the free-block list. 

BAD FREEBLK COUNT 

The count of free blocks in a free-list block is greater than 
50 or less than 0. This error condition will always invoke 
the BAD FREE LIST condition later in Phase 5. 

X BAD BLKS IN FREE LIST 

X blocks in the free-block list have a block number lower 
than the first data block in the filesystem or greater than the 
last block in the filesystem. This error condition will always 
invoke the BAD FREE LIST condition later in Phase 5. 
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X DUP BLKS IN FREE LIST 

X blocks claimed by i-nodes or earlier parts of the free-list 
block were found in the free-block list. This error condition 
will always invoke the BAD FREE LIST condition later in 
Phase 5. 

X BLK(S) MISSING 

X blocks unused by the filesystem were not found in the 
free-block list. This error condition will always invoke the 
BAD FREE LIST condition later in Phase 5. 

FREE BLK COUNT WRONG IN SUPERBLOCK (HX?) 

The actual count of free blocks does not match the count in 
the super-block of the filesystem. 

BAD FREE LIST (SALVAGE?) 

This message is always preceded by one or more of the 
Phase 5 information messages. If the -q option is specified, 
the free-block list will be salvaged automatically. 

Phase 6: Salvage Free List 



This phase reconstructs the free-block list. It has one possible error 
condition that results from bad blocks-per-cylinder and gap values. 



Phase 6 Error Messages 

DEFAULT FREE-BLOCK LIST SPACING ASSUMED 

This is an advisory message indicating the blocks-to-skip 
(gap) is greater than the blocks-per-cylinder, the blocks-to- 
skip is less than 1, the blocks-per-cylinder is less than 1, or 
the blocks-per-cylinder is greater than 500. The values of 7 
blocks-to-skip and 4(X) blocks-per-cylinder are used. 

Cleanup Phase 



Once a filesystem has been checked, a few cleanup functions are per- 
formed. The cleanup phase displays advisory messages about the 
filesystem and status of the filesystem. 



Cleanup Phase Messages 

X files Y blocks Z free 

This is an advisory message indicating that the filesystem 
checked contained X files using Y blocks leaving Z blocks 
free in the filesystem. 

***** BOOT XENIX (NO SYNC!) ***** 



March 19, 1991 



FSCK-15 



FSCK(ADM) 



FSCK(ADM) 



This is an advisory message indicating that a mounted 
filesystem or the root filesystem has been modified by fsck. 
If the UNIX system is not rebooted immediately witiiout 
sym:, the work done by fsck may be undone by the in-core 
copies of tables the UNIX system keeps. If the -b option of 
ihtfsck command was specified and the filesystem is root, a 
reboot is automatically done. 

***** FILE SYSTEM WAS MODIFIED ***** 

This is an advisory message indicating that the current 
filesystem was modified by fsck. 
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fsdb 



filesystem debugger 
Syntax 



/etc/fsdb special [ - ] 

Description 



fsdb can be used to patch up a damaged filesystem after a crash. It has 
conversions to translate block and i-numbers into their corresponding 
disk addresses. Also included are mnemonic offsets to access dif- 
ferent parts of an i-node. These greatly simplify the process of 
correcting control block entries or descending the filesystem tree. 

fsdb contains several error-checking routines to verify i-node and 
block addresses. These can be disabled if necessary by invoking /^rf^? 
with the optional - argument or by the use of the O symbol, (fsdb 
reads the i-size and f-size entries from the superblock of the filesys- 
tem as the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be 
prefixed with a zero. During any assignment operation, numbers are 
checked for a possible truncation error due to a size mismatch 
between source and destination. 

fsdb reads a block at a time and will therefore work with raw as well 
as block I/O. A buffer management routine is used to retain commonly 
used blocks of data in order to reduce the number of read system calls. 
All assignment operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized hy fsdb are: 



# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+,- address arithmetic 

q quit 

>,< save, restore an address 

= numerical assignment 

=+ incremental assignment 

=- decremental assignment 

=" character string assignment 
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O 

P 

f 

B 

W 

D 



error checking flip flop 
general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 



The print facilities generate a formatted output in various styles. The 
current address is normalized to an appropriate boundary before print- 
ing begins. It advances with the printing and is left at the address of 
the last item printed. The output can be terminated at any time by typ- 
ing the delete character. If a number follows the p symbol, that many 
entries are printed. A check is made to detect block boundary 
overflows since logically sequential blocks are generally not physi- 
cally sequential. If a count of zero is used, all entries to the end of the 
current block are printed. The print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with the current 
i-node. If followed by a number, that block of the file is printed. 
(Blocks are numbered from zero.) The desired print option letter fol- 
lows the block number, if present, or the f symbol. This print facility 
works for small as well as large files. It checks for special devices and 
that the block pointers used to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but are not 
necessary. A line with just a new-line character will increment the 
current address by the size of the data type last printed. That is, the 
address is set to the next byte, word, double word, directory entry or 
i-node, allowing the user to step through a region of a filesystem. In- 
formation is printed in a format appropriate to the data type. Bytes, 
words and double words are displayed with the octal address followed 
by the value in octal and decimal. A .B or .D is appended to the 
address for byte and double word values, respectively. Directories are 
printed as a directory slot offset followed by the decimal i-number and 
the character representation of the entry name. I-nodes are printed 
with labeled fields describing each element. 

The following mnemonics are used for i-node examination and refer to 
the current working i-node: 

md mode 
In link count 
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uid user ID number 

gid group ED number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 



Examples 



386i prints i-number 386 in an i-node format. This now 

becomes the current working i-node. 

ln=4 changes the link count for the working i-node to 4. 

ln=+l increments the link count by 1. 

fc prints, in ASCII, block zero of the file associated 

with the working i-node. 

2i.fd prints the first 32 directory entries for the root 

i-node of this filesystem. 

dSi.fc changes the current i-node to that associated with 

the 5th directory entry (numbered from zero) 
found from the above command. The first logical 
block of the file is then printed in ASCII. 

512B.p0o prints the superblock of this filesystem in octal. 

2i.a0b.d7=3 changes the i-number for the seventh directory slot 

in the root directory to 3. This example also 
shows how several operations can be combined on 
one command line. 

d7.nm="name" changes the name field in the directory slot to the 
given string. Quotes are optional when used with 
nm if the first character is alphabetic. 

a2b.p0d prints the third block of the current i-node as 

directory entries. 



Notes 



The directory /etc/fscmd.d/7TP£ contains programs for each filesys- 
tem type; each of these programs applies some appropriate heuristic to 
determine whether the supplied special file is of the type for which it 
checks. 
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See Also 



fsck(ADM), dir(F), filesystem(F), "Patching a Filesystem with fsdb" 
in the "Using Filesystems" chapter of the System Administrator's 
Guide 
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fsname 

prints or changes the name of a file system 

Syntax 

fsname [-p] [-s name ] /de\/device 

Description 

The letclfsname utility is used to print or change the name of a filesys- 
tem. The options are: 

-p Select the "pack" name field instead of the filesystem 

name field. 

-s name Changes the specified field in the superblock. 
The default action is to print the name of the filesystem. 

See Aiso 

mkfs(ADM), ustat(S), filesystem(F) 

Vaiue Added 

fsname is an extension of AT&T System V provided in Altos UNIX 
System V, 
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fsphoto 



performs periodic semi-automated system backups 
Syntax 



fsphoto [-i] schedule [ drive ] 

Description 



fsphoto, in conjunction with /fave (ADM), provides a semi-automated 
interface to xbackup^ADM) and cpio(C) for backing-up filesystems 
(xbackup can only be used to back up XENIX fileystems). A human 
operator is required to mount and dismount tapes or floppies at the ap- 
propriate times, so some interaction is necessary, but all such interac- 
tion is kept to a minimum to reduce the potential for human error. 

The selection and timing of backups for all filesystems is governed by 
the schedule (ADM) database. The system administrator must set up 
this file, and make arrangements to run fsphoto on the implicitly 
defined schedule (normally once per weekday), fsphoto can be 
invoked most easily from the sysadmsh(ADM). fsphoto interprets 
schedule, and for each filesystem that should be backed-up on that 
day, runs fsave to interact with the operator and backup the filesystem 
without error. 

The optional argument drive specifies the magtape or floppy device to 
use; the default is specified in the schedule file. 

Backups may be postponed (via. fsave) or interrupted. The resulting 
"partial" backups are automatically resumed the next time fsphoto is 
run: Any missed filesystems are backed-up as if the original backup 
had not been delayed. The -i flag ignores any pending partial backups. 

If there is a pending partial backup, the normally scheduled backups 
are not done. This means that if a partial backup is resumed, and the 
normally scheduled backups are to be done, fsphoto must be run twice. 

You must be the super-user to use this program. 

Files 



lusrlliblsysadminl schedule 

Database describing which filesystems are to be backed-up when, 
and at what dump level . 
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/dev/tty 

Source of interactive input. 

/usr/lib/sysadmin/past 

Record of filesystems successfully backed-up in the pending par- 
tial backup. 

/tmp/backupS^ 

Temporary file for recording successfully backed-up filesystems. 

See Also 



fsave(ADM), schedule(ADM), xbackup(ADM), basename(C) 

Diagnostics 



fsphoto complains of syntax errors in schedule , and exits with a status 
of 1. 

fsphoto complains about illegal or incorrect arguments, and exits with 
a status of 1. 

An interrupt will cause an exit status of 2. 

Notes 



If a drive is explicitly given, the "raw" (/dev/r*) form of the device 
should be used. 

Vaiue Added 



fsphoto is an extension to AT&T System V developed in Altos UNIX 
System V. 
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fsstat 



report file system status 
Syntax 



/etc/fsstat special_file 

Description 



The fsstat command reports on the status of the file system on 
special Jile . During startup, this command is used to determine if the 
file system needs checking before it is mounted. The fsstat command 
succeeds if the file system is unmounted and appears okay. For the 
root file system, it succeeds if the file system is active and not marked 
bad. 

See Also 



filesystem(F) 

Diagnostics 



The command has the following exit codes: 

0 the file system is not mounted and appears okay, (except for 
root where 0 means mounted and okay). 

1 the file system is not mounted and needs to be checked. 

2 the file system is mounted. 

3 the command failed. 



This command does not work on DOS filesy stems. 
The directory /etc/fscmd.d/TYPE contains programs for each file sys- 
tem iy^j^^ fsstat invokes the appropriate binary. 
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fstyp 



determine file system identifier 
Syntax 



fstyp device 

Description 



The fstyp command allows the user to determine the file system iden- 
tifier of mounted or unmounted file systems using heuristic programs. 
The file system type is required by mount(S) and sometimes by 
mount(ADM) to mount file systems of different types. 

fstyp runs the programs in /etc/fscmd.d/7YP£ in alphabetical order, 
passing device as an argument; if any program succeeds, its filesystem 
type identifier is printed and fstyp exits immediately. If no program 
succeeds, /jfyp prints "Unknown_fstyp" to indicate failure. 

See Also 



mount(ADM), mount(S), sysfs(S) 
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fwtmp, wtmpfix 



manipulate connect accounting records 
Syntax 



/usr/lib/acct/fwtmp [-ic] 
/usr/lib/acct/wtmpfix [files] 

Description 



fwtmp 

fwtmp reads from the standard input and writes to the standard output, 
converting binary records of the type found in wtmp to formatted 
ASCII records. The ASCII version is useful to enable editing, via 
ed(C), bad records or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and 
output is to be written in binary form. 



wtmpfix 

wtmpfix examines the standard input or named files in wtmp format, 
corrects the time/date stamps to make the entries consistent, and 
writes to the standard output. A - can be used in place of files to indi- 
cate the standard input. If time/date corrections are not performed, 
acctcon(ADM) will fault when it encounters certain date-change 
records. 

Each time the date is set, a pair of date change records are written to 
/etc/wtmp. The first record is the old date denoted by the string old 
time placed in the line field and the flag OLD_TIME placed in the 
type field of the <utmp.h> structure. The second record specifies the 
new date and is denoted by the string new time placed in the line field 
and the flag NEW_TIME placed in the type field, wtmpfix uses these 
records to synchronize all time stamps in the file. 

In addition to correcting time/date stamps, wtmpfix will check the 
validity of the name field to ensure that it consists solely of 
alphanumeric characters or spaces. If it encounters a name that is 
considered invalid, it will change the login name to INVALID and 
write a diagnostic to the standard error. In this way, wtmpfix reduces 
the chance that acctcon(ADM) will fail when processing connect 
accounting records. 
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/etc/wtmp 

See Also 



acct(ADM), acctcms(ADM), acctcom(C), acctcon(ADM), 
acctmerg(ADM), acctprc(ADM), acctsh(ADM), ed(C), 
runacct(ADM), acct(S), acct(F), utmp(F) 

Standards Conformance 



fwtmp and wtmpfix are conformant with: 
AT&TSVID Issue 2, Select Code 307-127. 
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goodpw 



check a password for non-obviousness 
Syntax 



goodpw [ -absm ] [ -d file ] [ -r reason ] [ -MR expr ] 

Description 



goodpw reads from the standard input a proposed password and 
applies a variety of heuristic checks intended to spot poor password 
choices. These checks can include checking against user names, 
English words, and too short or too simple passwords. Which checks 
are applied depends on the settings in /etc/default/goodpw, the file 
specified by the -d option, and the expressions specified by the -M 
and -R options. 

The first line read from the standard input is taken to be the proposed 
password. A list of "canonical forms" is then generated; the canoni- 
cal form is the password sans any non-letters and with all letters con- 
verted to upper-case. The list always includes the canonical form of 
the password and may, depending on the settings in 
/etc/default/goodpw, also contain left or right "rotations" of the 
canonical form. A rotation to the left is a shifting of the second 
through last character one position to the left, with the first character 
becoming the last; a rotation to the right is similar but in the opposite 
direction. The canonical list so generated is what most of the checks 
are applied against; if any (possibly rotated) canonical form in the list 
fails a check, the password is considered inadvisable and is rejected. 

Any subsequent lines read from the standard input are taken to be a 
"stop-list" of disallowed passwords. Each line in the stop-list is 
reduced to its canonical form and checked against the canonical list; if 
there is a match, the password is rejected. 

When a password is rejected, the reason is written to the standard 
error output and goodpw exits with a non-zero status. If a password 
passes all checks and hence is not rejected, no message is issued and 
goodpw exits with a zero status. 

The -s and -m options modify this behavior: If -s is specified, no rea- 
son is issued. If -m is specified, then: 

1. the stop-list terminates with an empty line, 

2. one line is written to the standard output indicating the accep- 
tance or rejection of the password, and 



March 19, 1990 



GOODPW-1 



GOODPW (ADM) 



GOODPW (ADM) 



3. the entire procedure is repeated using a new password and 
stop-list read from the standard input. 

This allows one goodpw process to check multiple passwords. The 
line written by goodpw to the standard output if -m is specified is one 
of: 

g The password passed all checks and seems to be acceptable. 
Treason 

The password was rejected for the indicated reason, 
e error 

The indicated system error occurred and it cannot be determined 
whether or not the password is acceptable. 

If -s was specified, then no reason or error is written after a "r" or 
"e," respectively. 

The other options are: 

-a Use American spelling (default). 

-b Use British spelling. 

-Treason 

Specify the message to be issued in case the proposed password 
matches one of those in the stop-list. The default reason is "same 
as previous password." 

-dfile 

Read the named file (which should be in the same format as 
/etc/default/goodpw) and apply the various checks specified. 

-Mexpr 

The password must match expr, a boolean combination of regular 
expressions. If the first character of expr is a slash ("/") and a reg- 
ular file by that name exists, the contents of that file are used as the 
expression. (If the file cannot be read, an error results.) 

-Rexpr 

The password must not match expr. 

The boolean combination of regular expressions (expr) is built from 
the following operations: 

expr^ & expr^ 

True if, and only if, both expressions expr and expr^ are true. If 
expr is not true, expr. is not evaluated. 
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expr^ I expr^ 

True if either (or both) of expr or expr is true. If expr. is true, 
expr^ is not evaluated. 

expr^ " expr^ 

True if exactly one of expr. and expr. are true. Both expr and 
expr^ are always evaluated. 

! expr 

True if ejcpr is not true; expr is always evaluated. 
( expr ) 

True if, and only if, expr is true; expr is always evaluated. 
/re/ 

True if, and only if, regular expression re matches the password. 
Any regular expression defined by regcmp(S) is understood; sub- 
strings defined by (...)$« are placed in "accumulator" n. 

$n " /re/ 

True if, and only if, accumulator n (0-9, or *) matches regular 
expression re; accumulator star ("*") is the entire password. 

$n !" /re/ 

True if, and only if, accumulator n is not matched by regular 
expression re. 

The possible goodpw checks, their control settings in 
/etc/default/goodpw, and default values are: 

MATCH=/usr/lib/goodpw/match 

An expression (expr), or the name of file containing an expression, 
that tfie password must match. This expression also may be 
specified by the -M option. 

REJECT=/usr/lib/goodpw/reject 

An expression, or the name of a file containing an expression, that 
the password must not match. This expression may also be 
specified by the -R option. 

LEFT_ROTATIONS=UNIQUE 

How left rotations of the canonical form of the password should be 
treated: NO - ignored; YES - considered in other checks (i.e., 
added to the canonical list) and may contain duplications; 
UNIQUE - considered in other checks but must not contain any 
duplicates. 

RIGHT_ROTATIONS=UNIQUE 
Similarly for right rotations. 



March 15, 1989 



GOODPW-3 



GOODPW(ADM) 



GOODPW(ADM) 



BOTH_ROTATIONS=UNIQUE 

Similarly for rotations in both directions taken together. 

AVOID_USERS=YES 

Should the canonical list be checked against user login names and 
real names, obtained from /etc/passwd? 

AVOID_GROUPS=YES 

Should the canonical list be checked against group names and 
group member lists, obtained from /etc/group? 

AVOID_MACfflNES=YES 

Should the canonical list be checked against machine names 
obtained from a number of files, including /etc/systemid and 
/usr/lib/mail/top ? 

AVOID_ALIASES=YES 

Should the canonical list be checked against mail aliases obtained 
from /usr/lib/mail/aliases? 

AVOID_WORDS=YES 

Should the canonical list be checked for properly spelled English 
words? 

BRITISH=NO 

Should spell use American or British spelling? Which spelling to 
use may be specified by the -a and -b options. 

SITECHECKS=NO 

The name of a program to run to provide additional checking. The 
program is run with no arguments. Passed to the program on its 
standard input, on separate lines, is first the actual proposed pass- 
word and then the canonical list. If the program exits with a non- 
zero status, the password is rejected. 

SITEREASON=Rejected by site-specific check(s) 

The reason to give when the SITECHECKS program rejects the 
password. 

The values for the default settings can be adjusted to reflect the local 
system's security concerns. If /etc/default/goodpw does not exist or 
cannot be read, the above default values are used (except for MATCH 
and REJECT). The default MATCH expression matches any pass- 
word which: 

1. Contains lower-case letters, upper-case letters, and digits, and 
whose length is four or more characters; or, 

2. Contains no lower-case letters, no upper-case letters, and no digits, 
and whose length is four or more characters; or. 
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3. Contains both lower-case letters md digits, or both upper-case 
letters and digits, or both lower- and upper-case letters, and whose 
length is five or more characters; or, 

4. Contains nothing but lower-case letters, and whose length is six or 
more characters; or, 

5. Contains nothing but upper-case latters, and whose length is six or 
more characters. 

The default REJECT expression is: 

/[Ss][Cc][Oo]/ 1 /[Xx][Ee][Nn][Ii][Xx]/ 

which matches any password that contains either "SCO" or 
"XENIX" regardless of case. 

Files 



/usr/Iib/ goodp w/match 

Expression that all passwords must match; by default, it contains 
the above-described MATCH expression. 

/usr/lib/ goodpw/reject 

Expression that no passwords should match; by default, it contains 
the above-described REJECT expression. 

See Also 



aliases(M), default(M), group(M), passwd(C), passwd(M), regex(S), 
spell(CT), systemid(M) 

Notes 



Not all valid English words are known to spell, and hence some 
English words are considered acceptable as passwords. 

The maximum length of a password is 100 characters, none of which 
may be an ASCII NUL or LF (newline). 

Empty passwords are always rejected. 

Value Added 



goodpw is an extension of AT&T System V provided in Altos UNIX 
System V. 
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graph 

draws a graph 

Syntax 

graph [ options ] 

Description 

The graph command with no options takes pairs of numbers from the 
standard input as abscissas and ordinates of a graph. Successive 
points are connected by straight Unes. The graph is encoded on the 
standard output for display by the tplot(ADM) filters. 



If the coordinates of a point are followed by a non-numeric string, that 
string is printed as a label beginning on the point. Labels may be sur- 
rounded with quotes in which case they may be empty or contain 
blanks and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the 

input); spacing is given by the next argument (default 1). 
A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by -x). 

-b Break (disconnect) the graph after each label in the input. 

-c Character string given by next argument is default label 

for each point. 

-g Next argument is grid style, 0 no grid, 1 frame with ticks, 

2 full grid (default). 
-1 Next argument is label for graph. 

-m Next argument is mode (style) of connecting lines: 0 

disconnected, 1 connected (default). Some devices give 
distinguishable line styles for other small integers (e.g., 
the Tektronix 4014: 2=dotted, 3=dash-dot, 4=short-dash, 
5=long-dash). 

-s Save screen, do not erase before plotting. 

-X [ 1 ] If 1 is present, x axis is logarithmic. Next 1 (or 2) argu- 
ments are lower (and upper) x limits. Third argument, if 
present, is grid spacing on x axis. Normally these quanti- 
ties are determined automatically. 

-y [ I ] Similarly for j . 

-h Next argument is fraction of space for height, 

-w Similarly for width. 

-r Next argument is fraction of space to move right before 

plotting. 
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-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now 

applies to the vertical axis.) 
A legend indicating grid range is produced with a grid unless the -s 
option is present. If a specified lower limit exceeds the upper limit, 
the axis is reversed. 

See Also 



graphics(ADM), tplot(ADM), spline(C) 

Notes 



The graph command stores all points internally and drops those for 
which there is no room. 

Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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haltsys, reboot 

closes out the file systems and shuts down the system 
Syntax 



/etc/haltsys [ -d ] 
/etc/reboot 

Description 



The haltsys utility performs a uadmin( ) system call (see uadmin(S)) to 
flush out pending disk I/O, mark the file systems clean, and halt the 
processor, haltsys takes effect immediately, so user processes should 
be killed beforehand. shutdown(ADM) is recommended for normal 
system shutdown, since it warns users, terminates processes, then calls 
haltsys. Use haltsys directly only if you cannot run shutdown; for 
example, because of some system problem. 

haltsys displays a prompt indicating that the system has been shut 
down and can be rebooted or powered down. If the -d option is used, 
the system will remain down and you are not given the option to 
reboot. 

The reboot command performs the same function as haltsys, except 
the system is rebooted automatically afterwards. 

Only the super-user can execute haltsys or reboot. 

Notes 



haltsys locks hard disk heads. 

See Also 



shutdn(S), uadmin(S), shutdown(ADM) 

reboot was developed at the University of California, Berkeley, and is 
used with permission. 

Value Added 



haltsys and reboot are extensions of AT&T System V provided in 
Altos UNIX System V. 
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hdutil 



hard disk utility for displaying and removing specific 
disk device names 

Syntax 



hdutil [-v] [ [-n device] I [-1 1 -d I -s drivej] ] 

Description 



The hdutil utility helps you manage the device filenames associated 
with hard disks. Use hdutil to: 

• Display a hard disk's device names and major/minor numbers. 

• Display any device names that are part of a virtual disk. 

• Remove a hard disk's device names. 

The hdutil utility displays all the device names associated with a 
specified hard disk, hdutil can also display the major and minor num- 
bers of the selected devices. It also lets you remove these device 
names (and delete references to them), thus allowing you to safely 
remove the hard disk. Once removed, the hard disk is inaccessible 
until the device nodes are added again with mkdev hd. 

Options 



-V Turn on verbose output. This causes the major and minor numbers 
for the displayed devices to be also shown. The -v option affects 
only options -n or -s. 

-n device 

Display all device files associated with the hard disk specified by 
the device name device. 

The name device can be any device file found in the /dev directory. 
Although special devices (like swap or recover) can be used as the 
argument, the most useful form is hddp, where d is the disk "num- 
ber" (really a letter), and p is the partition (e.g., hdaO). 

Disk numbers range from a to z and A to Z. Partition numbers 
range from 1 to a maximum of 4. Device names in the alternate 
UNIX form (e.g., lde\/dskldsp) are not recognized. See M(HW) 
for an explanation of device filename formats. 
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-1 drive Jt 

Display any devices associated with this hard disk that are com- 
ponents of a virtual disk. The argument drive Jt may be any 
currently used drive "number," which is really a letter ranging 
from a to z and A to Z. 

-s drive Jt 

Display all device files associated with the hard disk specified by 
drive Jt. The argument drive Jt may be any currently used drive 
"number," which is really a letter ranging from a to z and A to Z. 

-d drive Jt 

Delete all device nodes and file references to a hard disk specified 
by its drive Jt. The argument drive Jt may be any currently used 
drive "number," which is really a letter ranging from b to z and A 
toZ. 

(Note that you cannot delete drive a, which is always the root drive 
since it is the first drive installed on every system. 

Recall that the drive "number" letter represents the order in which 
you installed the drive, not its physical location. Thus, drive number b 
specifies the second drive added to the system; it might not be the 
drive in the second drive bay. 

Use scsinfoiADM) to determine the physical location of a specified 
hard disk number. 

Notes 



When a hard disk is removed with the -d option, all the device nodes 
associated with this disk in the /dev, /dev/rdsk, and the /dev/dsk 
directories are removed. All references to this disk in the following 
files are also removed: /etc/checklist, /etc/default/filesys, and 
/usr/lib/mkdev/perms/HD, 

Note that since hdutil makes no changes to the kernel, it is possible to 
add the disk again without having to reboot. If the disk is to be added 
again, use the mkdev hd command. However, the disk might not be 
the same disk number (that is, b, c, d, ...) as it was originally if any 
other disks were added or deleted since its removal. 

If the disk to be removed is part of a virtual disk or is currently 
mounted, hdutil will exit without removing any of its device nodes. 

Files 



/altos/bin/hdutil 

/etc/default/filesys 

/etc/checklist 
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/usr/lib/mkdev/perms/HD 

See Also 

mkdev(ADM), hd(HW), "Adding Hard Disks" and "Virtual Disks" 
in the System Administrator's Guide 

Value Added 

hdutil is an extension to AT&T System V provided in Altos UNIX Sys- 
tem V. 
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id 

print user and group IDs and names 
Syntax 

id 

Description 



The id command outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real IDs are dif- 
ferent, both are printed. 



See Also 



logname(C), getuid(S) 

Standards Conformance 



id is conformant with: 

AT«&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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idaddld 



add or remove line disciplines from kernel configura- 
tion files 

Syntax 



/etc/conf/bin/idaddid [-a name routinel ... routineS] [-de name] 

Description 



idaddld is used to add or remove line discipline declarations from ker- 
nel configuration files. If no arguments are given then idaddld enters 
an interactive mode. In this mode the user can add, delete or view the 
current configuration. If a change is specified then the user is 
prompted to relink the kernel. If arguments are given on the command 
line then idaddld enters a non-interactive mode executing the speci- 
fied command silently. It is the responsibility of the calling program 
to insure the kernel is relinked to effect the desired changes. 

Options 



The following options are available from the command line. 

-a prefix routinel ... routines 

Add a line discipline to configuration files. I*refix is a tag used to 
identify the line discipline for future inquiries or removal. For 
example, the terminal line discipline uses the prefix tty. Routinel 
through routines define the list of line discipline routines. There 
must be eight routines with the keyword "nulldev" used as a place- 
holder. The order of the routines is critical. They must be ordered 
as follows: 



open close read write ioctl rxint txint modemint 
-d prefix 

Remove the line discipline whose identifier matches prefix, 
-c prefix 

Scan the line discipline switch table for an entry which matches 
prefix. The program will exit with a return status 0 if a match is 
found and 1 otherwise. 
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IDADDLD (ADM) 



When a line discipline is added, it is appended to the current switch 
table configuration. 

Value Added 



idaddld is an extension of AT&T System V provided in Altos UNIX 
System V. 
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idbuild, idmkenv, idmkunix, idconfig, 
idvidi, idscsi 

build new UNIX system kernel 
Syntax 



/etc/conf/bin/idbuild 

Description 



This script builds a new UNIX system Icemel using the current system 
configuration in etc/conf/. Kernel reconfigurations are usually done 
after a device driver is installed, or system tunable parameters are 
modified. The script uses the shell variable $ROOT from the user's 
environment as its starting path. Except for the special case of kemel 
development in a non-root source tree, the shell variable ROOT 
should always be set to null or to *7." idbuild exits with a return code 
of zero on success and non-zero on failure. 

Building a new UNIX system image consists of generating new sys- 
tem configuration files, then link-editing the kemel and device driver 
object modules in the etc/conf/pack.d object tree. This is done by 
idbuild by calling the following commands: 

etc/conf/ bin/ idconfig To build kemel configuration files. 

etc/conf/ bin/ idmkunix To process the configuration files and link-edit 
a new UNIX system image. 

The system configuration files are built by processing the Master and 
System files representing device driver and tunable parameter specifi- 
cations. The files etc/conf/cf.d/mdevice, and etc/conf/cf.d/mtune 
represent the Master information. The file etc/conf/cf.d/stune, and the 
files specified in etc/conf/sdevice.d/* represent the System informa- 
tion. The kemel also has file system type information defined in the 
files specified by etc/conf/sfsys.d/* and etc/conf/mfsys.d/*. 

idvidi and idscsi read the video driver and SCSI driver configurations, 
respectively. 

idconfig reads the system configuration files and reports any conflicts 
and errors. 

idmkunix links the necessary modules to create the new kemel. 
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Once a new UNIX system kernel has been configured and linked, 
idmkdenv is invoked to back up the current /unix and replace it with 
the new kernel, and rebuild the kernel environment. 

Diagnostics 



Since idbuild calls other system commands to accomplish system 
reconfiguration and link editing, it will report all errors encountered 
by those commands, then clean up intermediate files created in the 
process. In general, the exit value 1 indicates an error was encoun- 
tered by idbuild. 

The errors encountered fall into the following categories: 

Master file error messages. 

System file error messages. 

Tlinable file error messages. 

Compiler and Link-editor error messages. 

All error messages are designed to be self-explanatory. 

See Also 



configure(ADM), idinstall(ADM), idtune(ADM), mdevice(F), 
mfsys(F), mtune(F), sdevice(F), sfsys(F), stune(F) 
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idcheck 



returns selected information 
Syntax 



/etc/conf/bin/idcheck 

Description 



This command returns selected information about the system configu- 
ration. It is useful in add-on device Driver Software Package (DSP) 
installation scripts to determine if a particular device driver has 
already been installed, or to verify that a particular interrupt vector, 
I/O address or other selectable parameter is in fact available for use. 
The various forms are: 

idcheck -p device-name [-i dir] [-r] 

idcheck -v vector [-i dir] [-r] 

idcheck -d dma-channel [-i dir] [-r] 

idcheck -a -1 lower_address -u upper_address [-i dir] [-r] 

idcheck -c -1 lower_address -u upper_address [-i dir] [-r] 

This command scans the System and Master modules and returns: 

100 if an error occurs. 

0 if no conflict exists. 

a positive number greater than 0 and less than 100 if a conflict 
exists. 

The command line options are: 

-r Report device name of any conflicting device on 

stdout. 

-p device-name This option checks for the existence of four different 
components of the DSP. The exit code is the addi- 
tion of the return codes from the four checks. 

Add 1 to the exit code if the DSP directory under 
/etc/conf/pack.d exists. 

Add 2 to the exit code if the Master module has been 
installed. 

Add 4 to the exit code if the System module has been 
installed. 
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-V vector 



Add 8 to the exit code if the Kernel was built with 
the System module. 

Add 16 to the exit code if a Driver.o is part of the 
DSP (vs. a stubs.c file). 

Returns "type" field of device that is using the vec- 
tor specified (i.e., another DSP is already using the 
vector). 



-d dma-channel Returns 1 if the dma channel specified is being used. 

-a This option checks whether the lOA region bounded 

by "lower" and "upper" conflict with another DSP 
("lower" and "upper" are specified with the -1 and 
-u options). The exit code is the addition of two 
different return codes. 

Add 1 to the exit code if the lOA region overlaps 
with another device. 

Add 2 to the exit code if the lOA region overlaps 
with another device and that device has the 'O' 
option specified in the type field of the Master 
module. The 'O' option permits a driver to overlap 
the lOA region of another driver. 

-c Retums 1 if the CMA region bounded by "lower" and 

"upper" conflict with another DSP ("lower" and 
"upper" are specified with the -1 and -u options). 

-1 address Lower bound of address range specified in hex. The 
leading Ox is unnecessary. 

-u address Upper bound of address range specified in hex. The 
leading Ox is unnecessary. 

-1 dir Specifies the directory in which the ID files sdevice 

and mdevice reside. The default directory is 
/etc/conf/cf.d. 



Diagnostics 



There are no error messages or checks for valid arguments to options. 
idcheck interprets these arguments using the rules of scanf(S) and 
queries &e sdevice and mdevice files. For example, if a letter is used 
in the place of a digit, scanf(S) will translate the letter to 0. idcheck 
will then use this value in its query. 

See Also 



idinstall(ADM), mdevice(F), sdevice(F) 
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idinstall 

add, delete, update, or get device driver configuration 
data 

Syntax 

/etc/conf/bin/idinstall -[adug] [-e] -[msoptnirhcl ] dev_name 

Description 

The idinstall command is called by a Driver Software Package (DSP) 
Install script or Remove script to Add (-a), Delete (-d), Update (-u), or 
Get (-g) device driver configuration data, idinstall expects to find 
driver component files in the current directory. When components are 
installed or updated, they are moved or appended to files in the 
/etc/conf directory and then deleted from the current directory unless 
the -k flag is used. The options for the command are as follows: 

Action Specifiers: 

-a Add the DSP components 

-d Remove the DSP components 

-u Update the DSP components 

-g Get the DSP components (print to std out, except Master) 
Component Specifiers: (*) 



-m 


Master component 


-s 


System component 


-o 


Driver.o component 


-p 


Space.c component 


-t 


Stubs.c component 


-n 


Node (special file) component 


-i 


Inittab component 


-r 


Device Initialization (rc) component 
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-h Device shutdown (sd) component 

-c Mfsys component: file system type config (Master) data 

-1 Sfsys component: file system type local (System) data 

(*) If no component is specified, the default is all except 
for the -g option where a single component must be 
specified explicitly. 

Miscellaneous: 

-e Disable free disk space check 

-k Keep files (do not remove from current directory) on add or 
update. 

In the simplest case of installing a new DSP, the command syntax 
used by the DSP's Install dinstascript should be idinstall -a dev name. 
In this case the command will require and install a Driver.o, Master 
and System entry, and optionally install the Space.c, Stubs.c, Node, 
Init, Rc, Shutdown, Mfsys, and Sfsys components if those modules are 
present in the current directory. 

The Driver.o, Space.c, and Stubs.c files are moved to a directory in 
/etc/conf/pack.d. The dev name is passed as an argument, which is 
used as the directory name. The remaining components are stored in 
the corresponding directories under /etc/conf in a file whose name is 
dev name. For example, the Node file would be moved to 
/etc7conf/node.d/dev_name. 

The idinstall -m usage provides an interface to the idmaster command 
which will add, delete, and update mdevice file entries using a Master 
file from the local directory. An interface is provided here so that 
driver writers have a consistent interface to install any DSP com- 
ponent. 

As stated above, driver writers will generally use only the idinstall -a 
dev name form of the command. Other options of idinstall are pro- 
vided to allow an Update DSP (i.e., one that replaces an existing de- 
vice driver component) to be installed, and to support installation of 
multiple controller boards of the same type. 

If the call to idinstall uses the -u (update) option, it will: 

overlay the files of the old DSP with the files of the new DSP. 

invoke the idmaster command with the 'update' option if a Mas- 
ter module is part of the new DSP. 

idinstall also does a verification that enough free disk space is avail- 
able to start the reconfiguration process. This is done by calling the 
idspace command, idinstall will fail if insufficient space exists, and 
exit with a non-zero retum code. The -e option bypasses this check. 
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idinstall makes a record of the last device installed in a file 
(/etc/.last dev add), and saves all removed files from the last delete 
operationln a 3irectory (/etc/.last_dev_del). These files are recovered 
by letclconflbinlidmkenv whenever it is determined that a system 
reconfiguration was aborted due to a power failure or unexpected sys- 
tem reboot. 

Diagnostics 



An exit value of zero indicates success. If an error was encountered, 
idinstall will exit with a non-zero value, and report an error message. 
All error messages are designed to be self-explanatory. Typical error 
message that can be generated by idinstall are as follows: 

Device package already exists. 

Cannot make the driver package directory. 

Cannot remove driver package directory. 

Local directory does not contain a Driver object (Driver. o) file. 

Local directory does not contain a Master file. 

Local directory does not contain a System file. 

Cannot remove driver entry. 

See Also 



idspace(ADM), idcheck(ADM), mdevice(F), sdevice(F) 
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idleout 



logs out idle users 
Syntax 



idleout [ minutes I hours:minutes ] 

Description 



The idleout command monitors line activity and logs out users whose 
terminal remains idle longer than a specified period of time. Minutes 
are assumed; if a colon appears in the number, hours are assumed. 

The utility uses a default file, /etc/ default/ idleout, to indicate the num- 
ber of hours a user's terminal may remain idle before being logged 
out. This file has one entry: 

IDLETIME=rime 

The time format is identical to that used on the command line. The 
time specified in the default file is overridden by idletime if idletime 
is specified on the command line. Note that, if idletime is zero, no 
monitoring takes place and idle users are not logged out. You can 
either run idleout ffrom the command line, or, to have continuous cov- 
erage, you must add the program name in /etc/rc.d/8/userdef to see to 
it that the program is run each time the system is rebooted. 

Files 



/etc/default/idleout 

/etc/utmp 

/etc/wtmp 

See Aiso 



who(C), getut(S), kill(S) 

Value Added 



idleout is an extension of AT&T System V provided in Altos UNIX 
System V. 
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idmemtune 



adjusts tunable parameters to match system memory 
Syntax 



/etc/conf/bin/idmemtune [ -f ] [ -r root ] [ -m memtune ] 
[ -M memsize ] [ -b basemem ] 

Description 



The idmemtune command uses the miemtune file to interactively con- 
figure tunable parameters to system memory size. Before adjusting 
each parameter, the user is prompted to either accept (by entering y) 
or reject the proposed change. Each parameter is then configured 
using idtune(ADM). 

Options 



-f Suppress the interactive mode and set tunable parameters silently, 
-r root 

Use root as an alternate root directory, below which other absolute 
pathnames are derived. This option overrides the ROOT environ- 
ment variable. 

-m memtune 

Use memtune as an altemate memtune file (the default is 
roof/etc/conf.d/memtune). 

-M memsize 

Adjust tunable parameters to match memsize instead of the actual 
system memory size. 

-b basemem 

Use the value basemem megabytes as the nase memory size corre- 
sponding to the base values in tiie memtune file instead of 8 mega- 
bytes. 



Files 



/etc/conf/cf.d/memtune 
/etc/conf/cf.d/stune 
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See Also 

idtune(ADM), uconfig(ADM), memtune(F), stune(F) 

Value Added 

idmemtune (ADM) is an extension to AT&T System V provided in 
Altos UNIX System V. 
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idmkinit 



read files containing specifications 
Syntax 



/etc/conf/bin/idmkinit 

Description 



This command reads the files containing specifications of /etc/inittab 
entries from /etc/conf/init.d and constructs a new inittab file in 
/etc/conf/cf.d. It returns 0 on success and a positive number on error. 

The files in /etc/conf/init.d are copies of the Init modules in device 
Driver Software Packages (DSP). There is at most one Init file per 
DSP. Each file contains one line for each inittab entry to be installed. 
There may be multiple lines (i.e., multiple inittab entries) per file. An 
inittab entry has the form (the id field is often called the tag): 

id:rstate:action:process 

The Init module entry must have one of the following forms: 

action :process 
rstate:action:process 
id:rstate raction :process 

When idmkinit encounters an entry of the first type, a valid id field 
will be generated, and an rstate field of 2 (indicating run on init 
state 2) will be generated. When an entry of the second type is 
encountered, only the id field is prefixed. An entry of the third type is 
incorporated into the new inittab unchanged. 

Since add-on inittab entries specify init state 2 for their rstate field 
most often, an entry of the first type should almost always be used. 
An entry of the second type may be specified if you need to specify 
other than state 2. DSP's should avoid specifying the id field as in the 
third entry since other add-on applications or DSPs may have abeady 
used the id value you have chosen. The /etc/init program will 
encounter serious errors if one or more inittab entries contain the 
same id field. 

idmkinit determines which of the three forms above is being used for 
the entry by requiring each entry to have a valid action keyword. 
Valid action values are as follows: 
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off 

respawn 

ondemand 

once 

wait 

boot 

bootwait 

powerfail 

powerwait 

initdefault 

sysinit 

The idmkinit command is called automatically upon entering init 
state 2 on the next system reboot after a kernel reconfiguration to 
establish the correct /etc/inittab for the running /unix kernel, idmkinit 
can be called as a user level command to test modiflcation of inittab 
before a DSP is actually built. It is also useful in installation scripts 
that do not reconfigure the kernel but need to create inittab entries. In 
this case, the inittab generated by idmkinit must be copied to 
/etc/inittab, and a telinit q command must be run to make tihe new 
entry take effect. 

The command line options are 

-o directory inittab will be created in the directory specified rather 
than /etc/conf/cf.d. 

-{directory The ID file initbase, which normally resides in 
/etc/conf/cf.d, can be found in the directory specified. 

-e directory The Init modules that are usually in /etc/conf/init.d can 
be found in the directory specified. 

-# Print debugging information. 

Diagnostics 



An exit value of zero indicates success. If an error was encountered, 
idmkinit will exit with a non-zero value and report an error message. 
All error messages are designed to be self-explanatory. 

See Also 



idbuild(ADM), idinstall(ADM), idmknod(ADM), init(M), inittab(F) 
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idmknod 



removes nodes and reads specifications of nodes 
Syntax 



/etc/conf/bin/idmknod 

Description 



This command performs the following functions: 

• Removes the nodes for non-required devices (those that do not 
have an *r' in field 3 of the device's mdevice entry) from /dev. 
Ordinary files will not be removed. If the /dev directory con- 
tains subdirectories, those subdirectories will be transversed 
and nodes found for non-required devices will be removed as 
well. If empty subdirectories result due to the removal of 
nodes, the subdirectories are then removed. 

• Reads the specifications of nodes given in the files contained in 
/etc/conf/node.d and installs these nodes in /dev. If the node 
specification defines a path containing subdirectories, the sub- 
directories will be made automatically. 

• Returns 0 on success and a positive number on error. 

The idmknod command is run automatically upon entering init state 2 
on the next system reboot after a kernel reconfiguration to establish 
the correct representation of device nodes in the /dev directory for the 
running /unix kernel, idmknod can be called as a user level command 
to test modification of the /dev directory before a DSP is actually 
built. It is also useful in installation scripts that do not reconfigure the 
kernel, but need to create /dev entries. 

The files in /etc/conf/node.d are copies of the Node modules installed 
by device Driver Software Packages (DSP). There is at most one file 
per DSP. Each file contains one line for each node that is to be 
installed. The format of each line is: 

Name of device entry (field 1) in the mdevice file (The mdevice 
entry will be the line installed by the DSP from its Master 
module). This field must be from 1 to 8 characters in length. The 
first character must be a letter. The others may be letters, digits, or 
underscores. 

Name of node to be inserted in /dev. The first character must be a 
letter. The others may be letters, digits, or underscores. This field 
can be a path relative to /dev, and idmknod will create 
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subdirectories as needed. 

The character b or c. A b indicates that the node is a 'block' type 
device and c indicates 'character' type device. 

Minor device number. This value must be between 0 and 255. If 
this field is a non-numeric, it is assumed to be a request for a 
streams clone device node, and idmknod will set the minor number 
to the value of the major number of the device specified. 

Some example node file entries are as follows: 

asy ttyOO c 1 

makes /dev/ttyOO for device 'asy' using minor device 1. 

qt rmt/cOsO c 4 

makes /dev/rmt/cOsO for device 'qt' using minor device 4. 

clone net/nau/clone c nau 

makes /dev/net/nau/clone for device 'clone'. The minor device 
number is set to the major device number of device 'nau'. 

The command line options are: 

-o directory Nodes will be installed in the directory specified rather 
than /dev. 

-i directory The file mdevice which normally resides in 
/etc/conf/cf.d, can be found in the directory specified. 

-e directory The Node modules that normally reside in 
/etc/conf/node.d can be found in the directory specified. 

-s Suppress removing nodes (just add new nodes). 

Diagnostics 



An exit value of zero indicates success. If an error was encountered 
due to a syntax or format error in a node entry, an advisory message 
will be printed to stdout and the command will continue. If a serious 
error is encountered (i.e., a required file cannot be found), idmknod 
will exit with a non-zero value and report an error message. All error 
messages are designed to be self-explanatory. 

See Also 



idinstall(ADM), idmkinit(ADM), mdevice(F), sdevice(F) 
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idspace 



investigates free space 
Syntax 



/etc/conf/bin/idspace [ -i modes ] [ -r blocks ] [ -u blocks ] 
[ -t blocks ] 

Description 



This command investigates free space in /, /usr, and /tmp filesystems 
to determine whether sufficient disk blocks and inodes exist in each of 
potentially 3 filesystems. The default tests that idspace performs are 
as follows: 

• Verify that the root filesystem (/) has 400 blocks more than the 
size of the current /unix. This verifies that a device driver 
being added to the current /unix can be built and placed in the 
root directory. A check is also made to insure that 100 inodes 
exist in the root directory. 

• Determine whether a /usr filesystem exists. If it does exist, a 
test is made that 400 free blocks and 100 inodes are available in 
that filesystem. If the filesystem does not exist, idspace does 
not complain since files created in /usr by the reconfiguration 
process will be created in the root filesystem and space require- 
ments are covered by the test above. 

• Determine whether a /tmp filesystem exists. If it does exist, a 
test is made that 400 free blocks and 100 inodes are available in 
that filesystem. If the filesystem does not exist, idspace does 
not complain since files created in /tmp by the reconfiguration 
process will be created in the root filesystem and space require- 
ments are covered by the test above. 

The command line options are: 

-i inodes This option overrides the default test for 100 inode in all of 
the idspace checks. 

-r blocks This option overrides the default test for /unix size + 400 
blocks when checking the root (/) filesystem. When the -r 
option is used, the /usr and /Imp filesystems are not tested 
unless explicitiy specified. 
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-u blocks This option overrides the default test for 400 blocks when 
checking the /usr filesystem. When the -u option is used, 
the root (/) and /tmp filesystems are not tested unless ex- 
plicitly specified. If /usr is not a separate filesystem, an 
error is reported. 

-t blocks This option overrides the default test for 400 blocks when 
checking the /tmp filesystem. When the -t option is used, 
the root (/) and /usr filesystems are not tested unless explic- 
itly specified. If /tmp is not a separate filesystem, an error 
is reported. 

Diagnostics 



An exit value of zero indicates success. If insufficient space exists in a 
filesystem or an error was encountered due to a syntax or format error, 
idspace will report a message. All error messages are designed to be 
self-explanatory. The specific exit values are as follows: 

0 success. 

1 command syntax error, or needed file does not exist. 

2 filesystem has insufficient space or inodes. 

3 requested filesystem does not exist (-u and -t options only). 

See Also 



idbuild(ADM), idinstall(ADM) 
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idtune 



attempts to set value of a tunable parameter 
Syntax 



/etc/conf/bin/idtune [ -f I -m ] name value 

Description 



This script attempts to set the value of a tunable parameter. The tun- 
able parameter to be changed is indicated by name. The desired value 
for the tunable parameter is value . 

If there is already a value for this parameter (in the stune file), the 
user will normally be asked to confirm the change with the following 
message: 

Tunable Parameter name ±s currently set to old value . 
Is it OK to change it to value? (y/n) 

If the user answers y, the change will be made. Otherwise, the tunable 
parameter will not be changed, and the following message will be dis- 
played: 

name left at old_yalue. 

However, if the -f (force) option is used, the change will always be 
made and no messages will ever be given. 

If the -m (minimum) option is used and there is an existing value 
which is greater than the desired value, no change will be made and no 
message will be given. 

If system tunable parameters are being modified as part of a device 
driver or application add-on package, it may not be desirable to 
prompt the user with the above question. The add-on package Install 
script may chose to override the existing value using the -f or -m 
options. However, care must be taken not to invalidate a tunable 
parameter modified earlier by the user or another add-on package. 

In order for the change in parameter to become effective, the UNIX 
system kernel must be rebuilt and the system rebooted. 
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Diagnostics 

The exit status will ne non-zero if errors are encountered. 

See Aiso 

idbuild(ADM), mtune(F), stune(F) 
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compare or print out terminfo descriptions 
Syntax 



infocmp [-d] [-C] [-n] [-1] [-L] [-C] [-r] [-u] [-s d|i|l|c] [-v] [-V] [-1] 
[-W width] [-A directory] [-B directory] [termname ...] 

Description 



The infocmp command can be used to compare a binary terminfo (F) 
entry with other terminfo entries, rewrite a terminfo (F) description to 
take advantage of the use= terminfo field, or print out a terminfo (F) 
description from the binary file [ferm(F)] in a variety of formats. In 
all cases, the Boolean fields will be printed first, followed by the 
numeric fields, followed by the string fields. 



Default Options 

If no options are specified and zero or one termnames are specified, 
the -I option will be assumed. If more than one termname is specified, 
the -d option will be assumed. 



Comparison Options [-d] [-c] [-n] 

The infocmp command compares the terminfo (F) description of the 
first terminal termname with each of the descriptions given by the 
entries for the other terminal's termnames. If a capability is defined 
for only one of the terminals, the value returned will depend on the 
type of the capability: F for boolean variables, -1 for integer vari- 
ables, and NULL for string variables. 

-d produce a list of each capability that is different. In this 

manner, if one has two entries for the same terminal or simi- 
lar terminals, using infocmp will show what is different 
between the two entries. This is sometimes necessary when 
more than one person produces an entry for the same termi- 
nal and one wants to see what is different between the two. 

-c produce a list of each capability that is common between the 

two entries. Capabilities that are not set are ignored. This 
option can be used as a quick check to see if the -u option is 
worth using. 
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•n produce a list of each capability that is in neither entry. If 
no termnames are given, the environment variable TERM 
will be used for both of the termnames . This can be used as 
a quick check to see if anything was left out of the descrip- 
tion. 



Source Listing Options [-1] [-L] [-C] [-r] 

The -I, -L, and -C options will produce a source listing for each termi- 
nal named. 

-I use the terminfo(F) names 

-L use the long C variable name listed in <term.h> 

-C use the termcap names 

-r when using -C, put out all capabilities in termcap form 

If no termnames are given, the environment variable TERM will be 
used for the terminal name. 

The source produced by the -C option may be used directly as a 
termcap entry, but not all of the parameterized strings may be changed 
to the termcap format, infocmp will attempt to convert most of the 
parameterized information, but that which it doesn't will be plainly 
marked in the output and commented out. These should be edited by 
hand. 

All padding information for strings will be collected together and 
placed at the beginning of the string where termcap expects it. Man- 
datory padding (padding information with a trailing '/') will become 
optional. 

All termcap variables no longer supported by terminfo(F), but which 
are derivable from other terminfo(F) variables, will be output. Not all 
terminfo(F) capabilities will be translated; only those variables which 
were part of termcap will normally be output. Specifying the -r 
option will take off this restriction, allowing all capabilities to be out- 
put in termcap form. 

Note that because padding is collected to the beginning of the capabil- 
ity, not all capabilities are output, mandatory padding is not supported, 
and termcap strings were not as flexible; it is not always possible to 
convert a terminfo(F) string capability into an equivalent termcap for- 
mat. Not all of these strings will be able to be converted. A subse- 
quent conversion of the termcap file back into terminfo(F) format will 
not necessarily reproduce the original terminfo(F) source. 
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Some common terminfo parameter sequences, their termcap 
equivalents, and some terminal types which commonly have such 
sequences are: 



Terminfo 

%pl%c 
%pl%d 

%pl%'x'%+%c 
%i 

%pl%?%'x'%>%t%pl%'y'%+%; 
%p2 is printed before %pl 



Termcap 


Representative Terminals 


%. 


adm 


%d 


hp, ANSI standard, vtlOO 


%+x 


concept 


%i 


ANSI standard, vtlOO 


%>xy 


concept 


%r 


hp 



Use= Option [-u] 

-u produce a terminfo (F) source description of the first terminal 
termname which is relative to the sum of the descriptions 
given by the entries for the other terminals' termnames. It 
does this by analyzing the differences between the first term- 
name and the other termnames and producing a description 
with use= fields for the other terminals. In this manner, it is 
possible to retrofit generic terminfo entries into a terminal's 
description. Or, if two similar terminals exist, but were 
coded at different times or by different people so that each 
description is a full description, using infocmp will show 
what can be done to change one description to be relative to 
the other. 

A capability will get printed with an at-sign (@) if it no longer exists 
in the first termname, but one of the other termname entries contains a 
value for it. A capability's value gets printed if the value in the first 
termname is not found in any of the ottier termname entries, or if the 
first of the other termname entries that has this capability gives a 
different value for the capability than that in the first termname . 

The order of the other termname entries is significant. Since the 
terminfo compiler tic(C) does a left-to-right scan of the capabilities, 
specifying two use= entries that contain differing entries for the same 
capabilities will produce different results depending on the order that 
the entries are given, infocmp will flag any such inconsistencies 
between the other termname entries as they are found. 

Alternatively, specifying a capability after a use= entry that contains 
that capability will cause the second specification to be ignored. 
Using infocmp to recreate a description can be a useful check to make 
sure that everything was specified correctly in the original source 
description. 

Another error that does not cause incorrect compiled files, but will 
slow down the compilation time, is specifying extra use= fields that 
are superfluous, infocmp will flag any other termname use= fields that 
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were not needed. 



Other Options [-s d|i|l|c] [-v] [-V] [-1] [-w width] 

-s sort the fields within each type according to the argument 

below: 

d leave fields in the order that they are stored in the 
terminfo data base. 

1 sort by terminfo name. 

1 sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be sorted 
alphabetically by the terminfo name within each type, 
except in the case of the -C or the -L options, which cause 
the sorting to be done by the termcap name or the long C 
variable name, respectively. 

-V print out tracing information on standard error as the pro- 

gram runs. 

-V print out the version of the program in use on standard error 
and exit. 

-1 cause the fields to print out one to a line. Otherwise, the 
fields will be printed several to a line to a maximum width 
of 60 characters. 

-w change the output to width characters. 



Changing Data Bases [-A directory] [-B directory] 

The location of the compiled terminfo(¥) data base is taken from the 
environment variable TERMINFO. If the variable is not defined or the 
terminal is not found in that location, the system terminfo(F) data 
base, usually in /usr/lib/terminfo, will be used. The options -A and 
-B may be used to override this location. The -A option will set TER- 
MINFO for the first termname and the -B option will set TERMINFO 
for the other termnames. With this, it is possible to compare descrip- 
tions for a terminal with the same name located in two different data 
bases. This is useful for comparing descriptions for the same terminal 
created by different people. Otherwise the terminals would have to be 
named differentiy in the terminfo(F) data base for a comparison to be 
made. 
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/usr/lib/terminfo/?/* compiled terminal description data 

base 

Diagnostics 



malloc is out of space! 

There was not enough memory available to process all 
the terminal descriptions requested. Run infocmp 
several times, each time including a subset of the desired 
termnames. 

use= order dependency found: 

A value specified in one relative terminal specification 
was different from that in another relative terminal spe- 
cification. 

'use=term' did not add anything to the descriptionJfl 

A relative terminal name did not contribute anything to 
the final description. 

must have at least two terminal names for a comparison to be done.lfl 
The -u, -d, and -c options require at least two terminal 
names. 

See Also 



captoinfo(ADM), tic(C), curses(S), term(F), terminfo(F) 
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initcond 



special security actions for init and getty 
Syntax 



initcond [ init I getty ] [ args ... ] 

Description 



To save space in the init(M) and getty(M) programs, which are mem- 
ory resident, the space intensive security actions are done in initcond 
as a sub-process of these programs. 

If the argument is init, one of two actions may occur. First, no argu- 
ment means that initcond should prompt for and verify a single user 
password if required by the System Default database. This is used for 
password checking before a single user shell. Second, if two other 
arguments are supplied, they are the terminal device name and the 
user name respectively of the session that just terminated. This infor- 
mation is reflected in both the Protected Password and Terminal Con- 
trol databases. 

If the argument is getty, and one additional argument is provided, it is 
the terminal to be invalidated before a login, initcond invalidates a 
terminal by setting a restricted set of permissions on the terminal de- 
vice and by using stopio(S) to invalidate all open file descriptors that 
reference the terminal. These include synonym devices for the same 
physical device as listed in the device assignment database. 

Files 



/tcb/files/initcondlog - Log file for init and getty events 
/etc/auth/system/ttys - Terminal Control database 
/etc/auth/system/devassign - Device Assignment database 

See Also 



getprtcent(S), stopio(S), getdvagent(S), "Maintaining System Secu- 
rity," chapter of the System Administrator's Guide 

Value Added 



initcond is an extension of AT&T System V provided in Altos UNIX 
System V. 
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initscript 



defines environment for programs executed by init(M) 
Description 



/etc/initscript is used to define the default environment for all com- 
mands started by init(M). It is the central location for environment 
variables that must be defined for a command. This avoids the prob- 
lems inherent in hard-coded values for such variables as HZ and 
PATH. The following is the default contents of /etc/initscript: 

PATH=/bin : /usr/bin 
export PATH 

HZ=60 
export HZ 

[ -X /etc/TIMEZONE ] && . /etc/TIMEZONE 
ulimit 1000 
eval exec "$4" 

Notes 



Variables other than TZ should not be defined in /etc/TIMEZONE as 
in previous releases; they should be moved to /etc/initscript. 

Value Added 



initscript is an extension of AT&T System V provided in Altos UNIX 
System V. 
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install 



install commands 
Syntax 



/etc/install [-c dira] [-f dirb] [-i] [-n dire] [-m mode] [-u user] 
[.g group] [-0] [-S] file [dirx . . .] 

Description 



The install command is most commonly used in "makefiles" [see 
make (CP)] to install a file (updated target file) in a specific place 
within a file system. Each file is installed by copying it into the ap- 
propriate directory, thereby retaining the mode and owner of the origi- 
nal command. The program prints messages telling the user exactly 
what files it is replacing or creating and where they are going. 

If no options or directories (dirx . . .) are given, install will search a 
set of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that 
order) for a file with the same name as file . When the first occurrence 
is found, install issues a message saying that it is overwriting that file 
with file , and proceeds to do so. If the file is not found, the program 
states this and exits without further action. 

If one or more directories (dirx ...) are specified after file, those 
directories will be searched before the directories specified in the 
default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory 

specified by dira, only if it is not found. If it 
is found, install issues a message saying that 
the file already exists, and exits without 
overwriting it. May be used alone or with the 
-s option. 

-f dirb Forces file to be installed in given directory, 

whether or not one already exists. If the file 
being installed does not already exist, the 
mode and owner of the new file will be set to 
755 and bin, respectively. If the file akeady 
exists, the mode and owner will be that of the 
already existing file. May be used alone or 
with the -o or -s options. 
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-i Ignores default directory list, searching only 

through the given directories (dirx . . .)• May 
be used alone or with any other options 
except -c and -f. 

-n dire If file is not found in any of the searched 

directories, it is put in the directory specified 
in dire. The mode and owner of the new file 
will be set to 755 and bin, respectively. May 
be used alone or with any other options 
except -c and -f. 

-m mode The mode of the new file is set to mode. Only 

available to the superuser. 

-u user The owner of the new file is set to user. Only 

available to the superuser. 

-g group The group id of the new file is set to group. 

Only available to the superuser. 

-o If file is found, this option saves the "found" 

file by copying it to OLDfile in the directory 
in which it was found. TThis option is useful 
when installing a frequently used file such as 
Ibinlsh or letclgetty, where the existing file 
cannot be removed. May be used alone or 
with any other options except -c. 

-s Suppresses printing of messages other than 

error messages. May be used alone or with 
any other options. 



See Also 



make(CP) 
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installpkg 

install package 

Syntax 

installpkg 

Description 

The installpkg command is used to install an AT&T-style UNIX sys- 
tem software package. 

You will have to be root to install certain packages successfully. 

You will be prompted to insert the floppy disk that the installation 
package resides on. Everything else is automatic. 

Notes 

You must invoke installpkg on the console. 

This command does not work on packages installed with 
custom(ADM). 

See Also 

displaypkg(ADM), removepkg(ADM) 
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integrity 

examine system files against the authentication data- 
base 

Syntax 



integrity [ -v ] [ -e ] [ -m ] 

Description 



integrity traverses the File Control database and compares each entry 
in turn to the real file in the file system. If the owner, group or per- 
missions are different, an error message is output. 

Wild card entries in the File Control database are handled as follows. 
For file names, those file names that have /* as the last entry are 
treated as wild cards. Any file in the directory matches that entry, 
unless the specific file under consideration has its own (non-wild 
card) entry in the database appearing before the wild card entry. In 
this case, the file is ignored in the check because it would have 
already been located previously. For owners (groups), if the File Con- 
trol entry does not explicitly list an owner (group), all owners (groups) 
match correctly. 

The -V option lists all files under consideration, even those that match. 
The -e option explains why discretionary checks fail and exactly what 
the discrepancy is. 

Normally, (non-wild card type) files in the File Control database that 
are missing from the file system are not reported. The -m option will 
override that default and report such missing files. 

Files 



/etc/auth/system/files - File Control database 
/etc/auth/system/default - System Defaults database 

See Also 



authck(ADM), stat(S), getprfient(S), "Maintaining System Security," 
chapter of the System Administrator's Guide 
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integrity returns a zero exit status if there are no discrepancies. Other- 
wise, integrity returns a positive value equal to the number of 
discrepancies. 

Value Added 



integrity is an extension of AT&T System V provided in Altos UNIX 
System V. 
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ipcrm 

removes a message queue, semaphore set or shared 
memory ID 

Syntax 



ipcrm [ options ] 

Description 



ipcrm removes one or more specified messages, a semaphore or 
shared memory identifiers. The identifiers are specified by the fol- 
lowing options: 



-q msqid removes the message queue identifier msqid from the 
system and destroys the message queue and data struc- 
ture associated with it. 



-m shmid removes the shared memory identifier shmid from the 
system. The shared memory segment and data structure 
associated with it are destroyed after the last detach. 

-s semid removes the semaphore identifier semid from the sys- 
tem and destroys the set of semaphores and data struc- 
ture associated with it. 



-Q msgkey removes the message queue identifier, created with key 
msgkey, from the system and destroys the message 
queue and data structure associated with it. 

-M shmkey removes the shared memory identifier, created with key 
shmkey, from the system. The shared memory segment 
and data structure associated with it are destroyed after 
the last detach. 



-S semkey removes the semaphore identifier, created with key 
semkey, from the system and destroys the set of sema- 
phores and data structure associated with it. 



The details of the removes are described in msgctl(S), shmctl(S), and 
semctl(S). The identifiers and keys may be found by using 
ipcs(ADM). 
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See Also 
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ipcs(ADM), msgctl(S), msgget(S), msgop(S), semctl(S), semget(S), 
semop(S), shmctl(S), shmget(S), shmop(S) 

Note 



ipcrm cannot be used to remove semaphores created using 
creatsem(S) or to remove shared memory created using sdget(S). 
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ipcs 

reports the status of inter-process communication 
facilities 

Syntax 



ipcs [ options ] 

Description 



ipcs prints certain information about active inter-process communica- 
tion facilities. Without options, information is printed in short format 
for message queues, shared memory, and semaphores that are 
currently active in the system. Otherwise, the information that is dis- 
played is controlled by the following options : 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 

-s Print information about active semaphores. 

If any of the options -q, -m, or -s are specified, information about only 
those indicated are displayed. If none of the three options are 
specified, information about all three are displayed. 

-b Print biggest allowable size information (maximum number of 
bytes in messages on queue for message queues, size of segments 
for shared memory, and number of semaphores in each set for 
semaphores). See below, for the meaning of columns in a listing. 

-c Print creator's login name and group name. See below. 

-o Display information on outstanding usage (number of messages on 
queue, total number of bytes in messages on queue, and the number 
of processes attached to shared memory segments). 

-p Display process number information. (Process ID of last process to 
send a message and process ID of last process to receive a message 
on message queues. It displays the process ID of the creating pro- 
cess and the process ID of the last process to attach or detach on 
shared memory segments.) See below. 

-t Print time information. (Time of the last control operation that 
changed the access permissions for all facilities. Time of last 
msgsnd and last msgrcv on message queues, last shmat and last 
shmdt on shared memory, and last semop(S) on semaphores.) See 
below. 

-a Use all print options . (This is a shorthand notation for -b, -c, -o, 

-p, and -t.) 
-C corefile 

Use the file corefile in place of /dev/kmem. 
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-N namelist 

The argument will be taken as the name of an alternate namelist 
(/unix is the default). 
-X Print information about XENIX interprocess communication, in 
addition to the standard interprocess communication status. The 
XENIX process information describes a second set of semaphores 
and shared memory. Note that the -p option does not print process 
number information for XENIX shared memory, and the -t option 
does not print time information about XENIX semaphores and 
shared memory. 

The column headings and the meaning of the columns in an ipcs list- 
ing are given below; the letters in parentheses indicate the options that 
cause the corresponding heading to appear; all means that the heading 
always appears. Note that these options only determine what informa- 
tion is provided for each facility; they do not determine which facili- 
ties will be listed. 



T (all) Type of the facility: 

q message queue; 
m shared memory segment; 
s semaphore. 
ID (all) The identifier for the facility entry. Note that ID is 

"X" for facilities created using creatsem(S) or 
sdgetiS). 

KEY (all) The key used as an argument to wjg^ef,5ew^er, or 
shmget to create the facility entry. (Note: The 
key of a shared memory segment is changed to 
IPC_PRrVATE from when the segment has been 
removed until all processes attached to the seg- 
ment detach it.) 

MODE (all) The facility access modes and flags: The mode 
consists of 11 characters that are interpreted as 
follows: 

The first two characters are: 

R if a process is waiting on a msgrcv; 
S if a process is waiting on a msgsnd; 
D if the associated shared memory segment 
has been removed. It will disappear when 
the last process attached to the segment 
detaches it; 

C if the associated shared memory segment 
is to be cleared when the first attach is 
executed; 

if the corresponding special flag is not set. 

The next 9 characters are interpreted as three sets 
of three bits each. The first set refers to the 
owner's permissions; the next to permissions of 
others in the user-group of the facility entry; and 
the last to all others. Within each set, the first 
character indicates permission to read, the second 



March 15, 1989 



IPCS-2 



IPCS (ADM) 



IPCS (ADM) 



character indicates permission to write or alter the 
facility entry, and the last character is currently 
unused. 



The permissions are indicated as follows: 



OWNER (all) 
GROUP (all) 

CREATOR(a,c) 
CGROUP(a,c) 

CBYTES (a,o) 

QNUM (a,o) 

QBYTES (a,b) 



LSPID 


(a,p) 


LRPID 


(a.p) 


STIME 


(a,t) 


RTIME 


(a,t) 


CTIME 


(a,t) 


NATTCH (a,o) 


SEGSZ 


(a,b) 


CPID 


(a,p) 


LPID 


(a,p) 


ATIME 


(a,t) 


DTIME 


(a,t) 


NSEMS 


(a.b) 


OTIME 


(a,t) 



r if read permission is granted; 

w if write permission is granted; 

a if alter permission is granted; 

- if the indicated permission is not granted. 
The login name of the owner of the facility entry. 
The group name of the group of the owner of the 
facility entry. 

The login name of the creator of the facility entry. 
The group name of the group of the creator of the 
facility entry. 

The number of bytes in messages currently out- 
standing on the associated message queue. 
The number of messages currently outstanding on 
the associated message queue. 
The maximum number of bytes allowed in mes- 
sages outstanding on the associated message 
queue. 

The process ID of the last process to send a mes- 
sage to the associated queue. 
The process ID of the last process to receive a 
message from the associated queue. 
The time the last message was sent to the associ- 
ated queue. 

The time the last message was received from the 
associated queue. 

The time when the associated entry was created or 
changed. 

The number of processes attached to the associ- 
ated shared memory segment. 
The size of the associated shared memory seg- 
ment. 

The process ED of the creator of the shared mem- 
ory entry. 

The process ID of the last process to attach or 
detach the shared memory segment. 
The time the last attach was completed to the 
associated shared memory segment. 
The time the last detach was completed on the 
associated shared memory segment. 
The number of semaphores in the set associated 
with the semaphore entry. 
The time the last semaphore operation was com- 
pleted on the set associated with the semaphore 
entry. 
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/unix system namelist 

/dev/kmem memory 

/etc/passwd user names 

/etc/group group names 

See Also 



msgop(S), semop(S), shmop(S) in the Programmer's Reference Manu- 
al 

Warning 



If the user specifies either the -C or -N flag, the real and effective 
UID/GID will be set to the real UID/GID of the user invoking ipcs. 

Notes 



Things can change while ipcs is running; the picture it gives is only a 
close approximation. 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the "Using a Trusted Sys- 
tem" chapter of the User's Guide for more details. 
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kbmode 

set keyboard mode or test keyboard support 

Syntax 

kbmode command [ file ] 

Description 

This command can be used to determine if your system keyboard sup- 
ports AT mode. If it does, this utility can change the keyboard mode in 
between AT mode and PC/XT compatibility mode. 

If the file argument is specified, it should be a tty device of one of the 
multiscreens of the keyboard's group. 

Valid commands are: 

test - determine if keyboard supports AT mode 

at - set keyboard to AT mode 

xt - set keyboard to PC/XT compatibility mode 

Notes 

Some keyboards look like AT keyboard but do not support AT mode. 
Setting such a keyboard to AT mode will render it useless, unless it 
can be set to XT mode from another (serial) terminal. 

See Also 

keyboard(HW) 

Value Added 

kbmode is an extension of AT&T System V provided in Altos UNIX 
System V. 



March 19, 1990 



KBMODE-1 



KILLALL(ADM) 



KILLALL(ADM) 



killall 

kill all active processes 

Syntax 

/etc/killall [ signal ] 

Description 

The killall command is used by /etc/shutdown to kill all active pro- 
cesses not directly related to the shutdown procedure. 

The killall command terminates all processes with open files so that 
the mounted file systems will be unbusied and can be unmounted. 

The killall command sends signal [see kill(C)] to all processes not 
belonging to the above group of exclusions. If no signal is specified, a 
default of 9 is used. 

Fiies 

/etc/shutdown 

See Also 

kill(C), ps(C), shutdown(ADM), signal(S) 

Notes 

The killall command can be run only by the super-user. 

Standards Conformance 

killall is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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labelit 



provide labels for filesystems 
Syntax 



/etc/labelit special [ fsname volume [ -n ] ] 

Description 



The labelit command can be used to provide labels for unmounted 
disk file systems or file systems being copied to tape. The -n option 
provides for initial labeling only. (This destroys previous contents.) 

With the optional arguments omitted, labelit prints current label 
values. 

The special name should be the physical disk section (e.g., 
/dev/dsk/0s3). The device may not be on a remote machine. 

The fsname argument represents the mounted name (e.g., root, ul, 
etc.) of the file system. 

Volume may be used to equate an internal name to a volume name 
applied externally to the disk pack, diskette, or tape. 

For file systems on disk, fsname and volume are recorded in the super 
block. 

See Also 

sh(C), filesystem(F) 

Standards Conformance 



labelit is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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LINK (ADM) 



link and unlink files and directories 



Syntax 



/etc/link filel file2 
/etc/unlink file 

Description 



The link command is used to create a file name that points to another 
file. Linked files and directories can be removed by the unlink com- 
mand; however, it is strongly recommended that the rm(C) and 
rmdir(C) commands be used instead of the unlink command. 

The only difference between ln(C) and link/ unlink is that the latter do 
exactly what they are told to do, abandoning all error checking. This 
is because they directly invoke the link(S) and unlink(S) system calls. 

See Aiso 



rm(C), link(S), unlink(S) 

Notes 



These commands can be run only by the super-user. 

Standards Conformance 



link and unlink are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

The X/Open Portability Guide II of January 1987; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 

System Support; 

and NIST FTPS 151-1. 
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link_unix 

builds a new UNIX system kernel 

Syntax 

/etc/conf/cf.d/link_unix 

Description 

After installing a device driver, use link unix to build a new UNIX 
system kernel. This script builds /etc/conF/cf.d/unix using the current 
system configuration in /etc/conf. 

See Also 



configure(ADM), idbuild(ADM), "Adding Device Drivers with the 
Link Kit' ' in the System Administrator's Guide 

Value Added 



link unix is an extension of AT&T System V provided in Altos UNIX 
System V. 
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list 



list processor channel for MMDF 
Syntax 



list 

Description 



List is an MMDF channel program for handling mailing lists. The 
channel functions as a feed-through between deliver and submit. The 
list channel has its own host table and domain table with one entry for 
the pseudo host "list-processor" or something similar. This program 
is called by the program deliver and is not meant to be invoked by 
users directiy. 

The list channel performs two basic services. First, it postpones the 
verification of the list addresses and performs the (possibly lengthy) 
verification in the background when the list channel resubmits the 
message to the mail system. This prevents tying up a network connec- 
tion or a user's terminal when verifying a long mailing list. Second, 
the list channel will, under special circumstances, change the return 
address for the message to a generic maintainer's address. The return 
address is determined by first taking the destination address (e.g. "lar- 
gelist") and seeing if there is an address in the alias file called 
"largelist-request' '. If there is, then "largelist-request' ' is used as the 
return address. If that was not found, the list channel checks to see if 
the destination address has a trailing "-outbound". If so, this is 
stripped and a "-request" is added and the lookup in the alias file is 
made a second time. If the "-request" address is found, then that 
address is used as the return address. If no "-request" address is 
found, then the original return address is used (normally the address of 
the sender). 

To use the list channel to process a list, it is generally necessary to 
make three entries in the alias file(s). Let us say that we wish to set up 
a list called "largelist" and we want this list to be processed by the 
list channel. We would need the following entries in the alias file: 

largelist: largelist-outbound@ list-processor 

largelist-outbound : </usr/mmdf/lists/largelist-file 
largelist-request: maintainer 

The first line causes mail sent to "largelist' ' to be sent through the list 
processor, readdressed to "largelist-outbound". The second line is 
what actually references the mailing list file for "largelist' '. The third 
line is optional, and is used to set up the (informal) standard mainte- 
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nance address. This -request address, if present, will also be used by 
the list channel as the return address for mail submitted to the list. 

See Also 



deliver(ADM), submit(ADM) 

Files 



<mmdf-table-directory>/ aliases - to find list-request addresses 
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Ipadmin 



configure the print service 
Syntax 



/usr/Iib/lpadmin -p printer options 
/usr/lib/lpadmin -x dest 
/usr/Iib/Ipadmin -d [dest] 

/usr/lib/lpadmin -S print-wheel -A alert-type [-W integer i ] 
[-Q integer 2 ] 

Description 



Ipadmin configures the LP print service to describe printers and de- 
vices. It is used to add and change printers, to remove printers from 
the service, to set or change the system default destination, and to 
define alerts for print wheels, and to define printers for remote print- 
ing services. 

Adding or Changing a Printer 



The first form of the Ipadmin command (Ipadmin -p printer options) 
is used to configure a new printer or to change the configuration of an 
existing printer. The following options are used and may appear in 
any order. For ease of discussion, the printer will be referred to as P 
below. 

-F fault-recovery 

Restores the LP print service after a printer fault according to 
the value of fault-recovery: 

continue Continues printing on the top of the page where print- 
ing stopped. This requires a filter to wait for the fault 
to clear before automatically continuing. 

beginning 

Starts printing the request again from the beginning. 

Disables printing on the printer and waits for the 
administrator or a user to enable printing again. 

During the wait, the administrator or the user who 
submitted the stopped print request can issue a change 
request that specifies where printing should resume. If 
no change request is made before printing is enabled, 
printing will resume at the top of the page where 
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stopped if the filter allows; otherwise, the request will 
be printed from the beginning. 

This option specifies the recovery to be used for any print 
request that is stopped because of a printer fault. 

-c class 

Inserts printer P into the specified class, class will be created if 
it does not already exist. 

-D comment 

Saves comment for display whenever a user asks for a full 
description of the printer P [see lpstat(Cy\. The LP print service 
does not interpret diis comment. 

-e printer 

Copies an existing printer's interface program to be the new 
interface program for printer P. 

-f 2iWoy/'.form-list 

-f deny:form-list 

Allows ("f allow) or denies (-f deny) the forms in form-list to be 
printed on printer P. 

For each printer, the LP print service keeps two lists of forms: 
an li' 'allow-list' ' of forms that can be used with the printer and 
a "deny-list" of forms that shouldn't be used with tiie printer. 
With the -f allow option, the forms listed are added to the 
allow-list and removed from the deny-list. With the -f deny 
option, the forms listed are removed from the allow-list and 
added to the deny-list. 

If the allow-list is not empty, the forms in the list can be used 
with the printer and all odiers cannot regardless of the content 
of the deny-list. If the allow-list is empty but the deny-list is 
not, the forms in the deny-list cannot be used with the printer. 
All forms can be excluded from a printer by having an empty 
allow-list and putting the word any in the deny-list. All forms 
can be used on a printer by having an empty deny-list and speci- 
fying any for the allow-list, provided the printer can handle all 
the characteristics of the forms. 

The LP print service uses this information as a set of guidelines 
for determining where a form can be mounted. Administrators, 
however, are not restricted from mounting a form on any printer. 
If mounting a form on a particular printer is in disagreement 
with the information in the allow-list or deny-list, the adminis- 
trator is warned, but the mount is accepted. Nonetheless, if a 
user attempts to issue a print or change request for a form and 
printer combination that is in disagreement with the informa- 
tion, the request is accepted only if the form is currently 
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mounted on the printer. If the form is later unmounted before 
the request can print, the request is canceled, and the user is 
notified by mail. 

If an administrator tries to name a form as acceptable for use on 
a printer that doesn't have the capabilities needed by the form, 
the command is rejected. 

Note the other use of -f below. 

-h Indicates that the device associated with P is hardwired. This 
option is assumed when adding a new printer unless the -1 
option is supplied. 

-i interface 

Establishes a new interface program for P. interface is the path 
name of the new program. 

-I content-type-list 

Assigns P to handle print requests with content of a type listed 
in content-type-list. 

The type simple is recognized as the default content-type of 
files on the system. Such a data stream contains only printable 
ASCII characters and the following control characters: 

Control Character Octal Value Meaning 

backspace 10„ move back to previous column. 



To force the print service to not consider simple as a valid type 
for the printer, give an explicit value (e.g., the printer type) in 
the content-type-list. If you do want simple included along with 
other types, you must include simple in the content-type-list. 

Each printer automatically has its printer type included in the 
list of content types it will accept. 

Except for simple, each content-type name is freely determined 
by the administrator. If names given as content types are also 
printer types, the names are accepted without comment because 
the LP print service recognizes all printer types as potential con- 
tent types as well. 

•I Indicates that the device associated with P is a login terminal. 
The LP scheduler, Ipsched, disables all login terminals automat- 
ically each time it is started. Before re-enabling /*, its current 
device should be established using Ipadmin. 



tab 

linefeed (newline) 
form feed 
carriage retum 



12 
15 



,8 

.8 
'8 



except at beginning of line 
move to next tab stop 
move to beginning of next line 
move to beginning of next page 
move to beginning of current line 
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-M -f form-name [-a [-o Hlebreak]] 

Mounts the form form-name on P. Print requests to be printed 
with the pre-printed form form-name will be printed on P. If 
more than one printer has the form mounted and the user has 
specified any (with the -d option of the Ip command) as the 
printer destination, then each print request will be printed on the 
one that meets the other needs of the request. 

The page length and width and character and line pitches 
needed by the form are compared with those allowed for the 
printer by checking the capabilities in the terminfo(F) database 
for the type of printer. If the form requires attributes that are not 
available with the printer, the administrator is warned, but the 
mount is accepted. If the form lists a print wheel as mandatory 
but the print wheel mounted on the printer is different, the 
administrator is also warned but the mount is accepted. 

If the -a option is given, an alignment pattern is printed, pre- 
ceded by the same initialization of the physical printer that pre- 
cedes a normal print request with one exception: no banner 
page is printed. Printing is assumed to start at the top of the first 
page of the form. After the pattern is printed, the administrator 
can adjust the mounted form in the printer, press return for 
another alignment pattern (no initialization this time), and con- 
tinue printing as many alignment patterns as desired. The 
administrator can quit the printing alignment patterns by typing 
"q". 

If the -o filebreak option is given, a formfeed is inserted 
between each copy of the alignment pattern. By default, the 
alignment pattern is assumed to correctly fill a form, so no 
formfeed is added. 

A form is unmounted by mounting a new form in its place using 
the -f option. The -f none option can be used to specify no form. 
By default, a new printer has no form mounted. 

Note the other use of -f above. 

-M -S print-wheel 

Mounts the print wheel print-wheel on P. Print requests to be 
printed with print-wheel will be printed on P. If more than one 
printer has the print-wheel mounted and the user has specified 
any (with the -d option of the Ip command) as the printer desti- 
nation, then each print request will be printed on the one that 
meets the other needs of the request. 

If the print-wheel is not listed as acceptable for the printer, the 
administrator is warned, but the, mount is accepted. If the 
printer does not take print wheels, the command is rejected. 
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A print wheel is unmounted by mounting a new print wheel in 
its place or by using the -S none option. 

By default, a new printer has no special print wheel mounted. 
Until this is changed, a print request that asks for a specific print 
wheel will not be printed on P. 

Note the other uses of the -S option described below. 

-m model 

Selects a model interface program provided with the LP print 
service for printer P. 

-o printing-option 

Each -o option in the list below is the default given to an inter- 
face program if the option is not taken from a preprinted form 
description or is not explicitly given by the user submitting a 
request [see /p(C)]. The only -o options that can have defaults 
defined are listed below: 

lQngth=scaled-decimal-number 

yndth=scaled-decimal-number 

cpi=scaled-decimal-number 

lpi=scaled-decimal-nuniber 

stty=stty-option-list 

The term scaled-decimal-number refers to a non-negative num- 
ber used to indicate a unit of size. (The type of unit is shown by 
a trailing letter attached to the number.) Three types of scaled 
decimal numbers are discussed for the LP print service: num- 
bers that show sizes in centimeters (marked with a trailing c), 
numbers that show sizes in inches (marked with a trailing i), and 
numbers that show sizes in units appropriate to use (without a 
trailing letter), i.e., lines, columns, lines per inch, or characters 
per inch. 

The first four default option values should agree with the capa- 
bilities of the type of physical printer as defined in the 
terminfo(F) database for tiie printer type. If they do not, the 
command is rejected. 

The stty-option-list is not checked for allowed values but is 
passed directly to the stty{C) program by the standard interface 
program. Any error messages produced by stty{C) when a 
request is processed (by the standard interface program) are 
mailed to the user submitting the request. 

For each printing option not specified, the defaults for the fol- 
lowing attributes are defined in the Terminfo entry for the 
specified printer type: 

length 
width 
cpi 
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Ipi 

The default for stty is 

stty=9600 cs8 -cstopb -parenb -paroff ixon 
-ixany opost -olcuc -onlcr -ocml -onocr 
-onlret -ofiU nlO crO tabO bsO vtO fEO 

You can set any of the -o options to the default values (which 
vary for different types of printers) by typing them without 
assigned values as follows: 

length= 

width= 

cpi= 

lpi= 

stty= 

-o nobanner 

Allows users to submit a print request that asks that no banner 
page be printed. 

-o banner 

Forces a banner page to be printed with every print request, 
even when a user asks for no banner page. This is the default; 
you must specify -o nobanner if you want to allow users to 
specify -o nobanner with the Ip command. 

-R machine-list 

Sets up remote machines in machine-list to share print services. 
The LP print service arranges for the advertising and mounting 
of all necessary resources and for automatic recovery of shared 
print services when the machine is brought to a state where RFS 
is run. 

The LP Spooler keeps the parts of the print service owned by 
each machine separate, so that the administrator on one machine 
can change only the service provided by his or her machine. 
The LP Spooler provides for no centrally managed print service 
using RFS. 

-r class 

Removes printer P from the specified class. If P is the last 
member of the class, then the class will be removed. 

-S list 

Allows the aliases for character sets or print wheels named m 
list to be used with P. 

If the printer is a type that takes print wheels, then list is a list of 
print wheel names separated by commas or spaces. These will 
be the only print wheels considered mountable on the printer. 
(You can always force a different print wheel to be mounted, 
however.) Until the option is used to specify a list, no print 
wheels will be considered mountable on the printer, and print 
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requests that ask for a particular print wheel with this printer 
will be rejected. 

If the printer is a type that has selectable character sets, then list 
is a list of character set name mappings or aliases separated by 
conimas or spaces. Each mapping is of the form 

known-name = synonym 

known-name is a character set number preceded by cs, such as cs3 for 
character set three, or a character set name from the Terminfo data- 
base csnm entry. [See terminfo(¥) in the Programmer's Reference 
Manual.] If this option is not used to specify a list, only the names 
akeady known from the Terminfo database or numbers with a prefix of 
cs will be acceptable for the printer. 

If list is the word none, the previous print wheel list or character set 
aliases will be removed. 

Note the other uses of the -S option. 
-T printer-type 

Assigns the given printer-type, a representation of a physical 
printer of type printer-type. Printer-type is used to extract data 
from terminfo(F); this data is used to initialize the printer before 
printing each user's request. Some filters may also use printer- 
type to convert content for the printer. If this option is not used, 
the default printer-type will be unknown; no useful information 
will be extracted from terminfo(F), so each user request will be 
printed without first initializing the printer. Also, this option 
must be used if the following are to work: -o cpi=, -o lpi=, -o 
width=, and -o Iength= options of the Ipadmin and Ip com- 
mands, and the -S and -f options of the Ipadmin command. 

-u allow:user-list 

-u deny :user-list 

Allows (-U allow) or denies (-u deny) the users in user-list 
access to P. 

For normal access to each printer, the LP print service keeps two 
lists of users: an allow-list of people allowed to use the printer 
and a deny-list of people denied access to the printer. With the 
-u allow option, the users listed are added to the allow-list and 
removed from the deny-list. With the -u deny option, the users 
listed are removed from the allow-list and added to the deny- 
list. 

If the allow-list is not empty, the users in the list are allowed 
access to the printer and all others are denied access, regardless 
of the content of the deny-list. If the allow-list is empty but the 
deny-list is not, the users in the deny-list are denied access and 
all others are allowed. If both lists are empty, all users are 
allowed access. Access can be denied to all users except the LP 
print service administrator by putting any in the deny-list. To 
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allow everyone access to P and effectively empty both lists, put 
any in the allow-list. 

-U dial-info 

Assigns the dialing information dial-info to the printer, dial- 
info is used with the dial(S) routine to call the printer. Any net- 
work connection supported by the Basic Networking Utilities 
will work, dial-info can be either a phone number for a modem 
connection or a system name for other kinds of connections. Or 
if -U direct is given, no dialing will take place because the 
name direct is reserved for a printer that is directly connected. 
If a system name is given, it is used to search for connection 
details from the file /usr/Iib/uucp/Systems or related files. The 
Basic Networking Utilities are required to support this option. 
By default, -U direct is assumed. 

-V device 

Associates a new device with printer P. device is the path name 
of a file that is writable by Ip . Note that the same device can be 
associated with more than one printer. 

-A alert-type [-W integer] 

The -A option is used to send the alert alert-type to the adminis- 
trator when a printer fault is detected and periodically thereafter 
until the printer fault is cleared by the administrator. The alert- 
types are 

mail 

Sends the alert message via mail [see mail(C)] to the 
administrator who issues this command. 

write 

Writes the message to the terminal on which the administra- 
tor is logged in. If the administrator is logged in on several 
terminals, one is chosen arbitrarily. 

quiet 

Does not send messages for the current condition. An 
administrator can use this option to temporarily stop receiv- 
ing further messages about a known problem. Once the fault 
has been cleared and printing resumes, messages will again 
be sent when another fault occurs with the printer. 

none 

Does not send messages until this command is given again 
with a different alert-type; removes any existing aiert 
definition. No alert will be sent when the printer faults until 
a different alert-type is used (except quiet). 

shell-command 

shell-command is run each time the alert needs to be sent. 
shell-command should expect the message as standard input. 
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If there are blanks embedded in the command, enclose the 
command in quotes. Note that the mail and write values for 
this option are equivalent to the values mail user-name and 
write user-namey respectively, where user-name is the 
current name for the administrator. This will be the login 
name of the person submitting this command unless he or 
she has used the su command to change to another user ID. 
If the su command has been used to change the user ID, then 
the user-name for the new ID is used. 

list 

The type of the alert for the printer fault is displayed on the 
standard output. No change is made to the alert. 

The message sent appears as follows: 

The print wheel print-wheel needs to be mounted 

on the printer(s): 

printer-list 

number-of-requests print requests await this print-wheel. 

The printer printer-name has stopped printing for the reason given 
below. Fix the problem and bring the printer back on line. Printing 
has stopped but will be restarted in a few minutes; issue an enable 
command if you want to restart sooner. 

Unless someone issues a change request 

Ip -i request-id -P . . . 

to change the page-list to print, the current request will be repeated 
from the beginning. 

The reason(s) it stopped (multiple reasons indicate reprinted 
attempts): 

reason 

The LP print service can detect printer faults only through an adequate 
fast filter and only when the standard interface program or a suitable 
customized interface program is used. Furthermore, the level of 
recovery after a fault depends on the capabilities of the filter. 

If the printer-name is all, the alerting defined in this command applies 
to all existing printers. 

If the -W option is not given or integer \ is zero (which represents 
once and is also the default), only one message will be sent per fault. 
If this command is not used to arrange fault alerting for a printer, the 
default procedure is to mail one message to the administrator of the 
printer per fault. 
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When creating a new printer, either the -v or the -U option must be 
supplied. In addition, only one of the following may be supplied: -e, 
-i, or -m; if none of these three options are supplied, the model stan- 
dard is used. The -h and -1 keyletters are mutudly exclusive. F*rinter 
and class names may be no longer than 14 characters and must consist 
entirely of the characters A-Z, a-z, 0-9 and _ (underscore). 

Removing a Printer Destination 



The -X dest option removes the destination dest from the LP print ser- 
vice. If dest is a printer and is the only member of a class, then the 
class will be deleted, too. If dest is all, all printers and classes are 
removed. No other options are allowed with -x. 

Changing the System Default Destination 



The -d [dest] option makes dest, an existing destination, the new sys- 
tem default destination. If dest is not supplied, then there is no system 
default destination. No other options are allowed with -d. 

Setting an Alert for a Print Wheel 



-S print-wheel -A alert-type [-W integer i ] [-Q integer 2 ] 

The -S print-wheel option is used with the -A alert-type option 
to send the alert alert-type to the administrator as soon as the 
print-wheel needs to be mounted and periodically thereafter. 
The alert-types are 

mail Sends the alert message via mail [see mail(C)] to the 
administrator who issues this command. 

write Writes the message to the terminal on which the 
administrator is logged in. If the administrator is 
logged in on several terminals, one is chosen arbi- 
trarily. 

quiet Does not send messages for the current condition. An 
administrator can use this option to temporarily stop 
receiving further messages about a known problem. 
Once the print-wheel has been mounted and subse- 
quently unmounted, messages will again be sent when 
the number of print requests again exceeds the thresh- 
old. 
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none Does not send messages until this command is given 
again with a different alert-type (other than quiet). 

shell-command 

The shell-command is run each time the alert needs to 
be sent. The shell command should expect the mes- 
sage as standard input. If there are blanks embedded 
in the command, enclose the command in quotes. 
Note that the mail and write values for this option are 
equivalent to the values mail user-name and write 
user-name, respectively, where user-name is the 
current name for the administrator. This will be the 
login name of the person submitting this command 
unless he or she has used the su command to change to 
another user ID. If the su command has been used to 
change the user ID, then the user-name for the new ID 
is used. 

list The type of the alert for the print wheel is displayed 
on the standard output. No change is made to the 
alert. 

The printers listed are those that the administrator had earlier 
specified were candidates for this print wheel. The number ( 
integer 3 ) listed next to each printer is the number of requests 
eligible for the printer. The number ( integer 4 ) shown after the 
printer list is the total number of requests awaiting the print 
wheel. It will be less than the sum of the other numbers if some 
requests can be handled by more than one printer. 

If the print-wheel is all, the alerting defined in this command 
applies to all print wheels already defined to have an alert. 

Only one administrator per print wheel can be alerted. If this 
command is run by more than one administrator for the same 
print wheel, the last command run applies. 

If the -W option is not given or integer j is zero (which is inter- 
preted as once and is also the default), only one message will be 
sent per need to mount a print wheel. If this command is not 
used to arrange alerting for a print wheel, no alerts will be sent 
for the print wheel. 

If the -Q option is also given, the alert will be made when 
integer 2 print requests that need the print wheel are waiting. If 
the -Q option is not given or integer 2 is 1 or the word any, a 
message is sent as soon as anyone submits a print request for the 
print wheel when it is not mounted. 

The -S option has a different meaning when used with the -p 
option. 
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Defining Remote Printers for Remote Printing Services 



The fourth forni of the Ipadmin command is used to define the remote 
printer, printer-name^, and its machine, machine-name, that will han- 
dle remote print reqirests from the local machine. The remote printer 
will be be referred to as printer-name j on the local machine. 

Files 



/usr/spool/lp/* 

See Also 



accept(ADM), enable(C), lp(C), Ipstat(C), stty(C), Ipsched(ADM), 
terminfo(F) 

Authorization 



Permission to use this utility is assigned with the Ip authorization, 
which is usually reserved for system administrators. 
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Ipfilter 



administer filters used witli tiie print service 
Syntax 



/usr/lib/lpfilter -f filter-name -F path-name 
/usr/lib/lpfilter -f filter-name - 
/usr/lib/lpfilter -f filter-name -i 
/usr/lib/lpfilter -f filter-name -x 
/usr/lib/lpfilter -f filter-name -1 

Description 



The Ipfilter command is used to add, change, delete, and list filters 
used with the LP print service. These filters are used to convert the 
content type of a file to a content type acceptable to a given printer. 
One of the following options must be used with the Ipfilter command: 
-F path-name (or - for standard input) to add or change a filter, -i to 
reset an original LP print service filter to its factory setting, -x to 
delete a filter, or -1 to list a filter description. 

The argument all can be used instead of a filter-name with any of 
these options. When all is specified with the -F or - option, the 
requested change is made to all filters. Using all with the -i option has 
the effect of restoring to their original settings all filters for which 
predefined settings were initially available. Using the all argument 
with the -1 option produces a list of all filters, and using it with the -x 
option results in all filters being deleted. 

Adding or Changing a Filter 



The filter named in the -f option and described in the input is added to 
the filter table. If the filter already exists, its description is changed to 
reflect the new information in the input. Once added, a filter is avail- 
able for use. 

The filter description is taken from the path-name if the -F option is 
given or from the standard input if the - option is given. One of the 
two must be given to define or change a filter. If tihe filter named is 
one originally delivered with the LP print service, the -i option will 
restore the original filter description. 

Filters are used to convert the content of a request into a data stream 
acceptable to a printer. For a given print request, the LP print service 
will know the following: 
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• the type of content in the request 

• the name of the printer 

• the type of the printer 

• the types of content acceptable to the printer 

• the modes of printing asked for by the originator of the request 

It will use this information to find a filter that will convert the content 
into a type acceptable to the printer. 

Below is a list of items that provide input to this command and 
descriptions of each item. All lists are separated by commas or 
spaces. 

Input types: content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers: printer-list 
Filter type: filter-type 
Command: shell-command 
Options: template-list 

Input types 

This gives the types of content that can be accepted by the filter. 
Output types 

This gives the types of content that the filter can produce from any 
of the input content types. 

Printer types 

This gives the type of printers for which the filter can be used. The 
LP print service will restrict the use of the filter to these types of 
printers. 

Printers 

This gives the names of the printers for which the filter can be 
used. The LP print service will restrict the use of the filter to just 
the printers named. 

Filter type 

This marks the filter as a "slow" filter or a "fast" filter. Slow 
filters are generally those that take a long time to convert their 
input. They are run unconnected to a printer to keep the printers 
from being tied up while the filter is running. Fast filters are gen- 
erally those that convert their input quickly or those that must be 
connected to the printer when run. These will be given to the 
interface program to run connected to the physical printer. 
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Command 

This specifies the program to run to invoke the filter. The program 
name as well as fixed options are included in the shell-command; 
additional options are constructed, based on the characteristics of 
each print request and on the Options field. 

The command must accept a data stream as standard input and pro- 
duce the converted data stream on its standard output. This allows 
filter pipelines to be constructed to convert data not handled by a 
single filter. 

Options 

This is a list of templates separated by commas used by the LP 
print service to construct options to the filter from the characteris- 
tics of each print request listed in the table later. In general, each 
template is of the following form: 

keyword pattern = replacement 

The keyword names the characteristic that the template attempts to 
map into a filter-specific option; each valid keyword is listed in the 
table below. A pattern is either a literal pattern of one of the forms 
listed in the table or a single asterisk, *; if the pattern matches the 
value of the characteristic, the template fits and is used to generate 
a filter-specific option. A pattern of * matches any value. The 
replacement is a string used as a filter-specific option with an 
embedded asterisk, *, replaced with the value of the characteristic. 



Ip Option 


Characteristic 


keyword 


Possible 


-T 


Content type (input) 


INPUT 


content-type 


N/A 


Content type (output) 


OUTPUT 


content-type 


N/A 


Printer type 


TERM 


printer-type 


-f, -0 cpi= 


Character pitch 


CPI 


integer 


-f, -0 lpi= 


Line pitch 


LPI 


integer 


-f, -0 length= 


Page length 


LENGTH 


integer 


-f, -0 width= 


Page width 


WIDTH 


integer 


-P 


Pages to print 


PAGES 


page-list 


-S 


Character set/ 


CHARSET 


character-set- 




print wheel 




name/ 








print-wheel-name 


-f 


Form name 


FORM 


form-name 


-y 


Modes 


MODES 


mode 


-n 


Number of copies 


COPIES 


integer 



For example, the template 

MODES landscape = -1 

would show that if a print request includes the -y landscape option, 
the filter should be given the option -1. As another example, the tem- 
plate 
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TERM * = -T * 

would show that the filter should be given the option -T printer-type 
for whichever printer-type is associated with a print request using tihe 
filter. 

When an existing filter is changed with this command, items that are 
not specified in the new information are left as they were. When a 
new filter is added with this command, unspecified items are given 
default values. 

Note that a filter name and a command must be given. A filter with no 
input type value is assumed to work with any input type; this is also 
true for the output type, printer type, and printer values. 

Deleting a Filter 



The -X option is used to delete the filter specified in filter-name from 
the LP filter table. 

Listing a Filter Description 



The -I option is used to list the description of the filter named in 
filter-name. If the command is successful, the following message is 
sent to standard output: 

Input types: content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers: printer-list 
Filter tyj^: filter-type 
Command: shell-command 
Options: template-list 

If the command fails, an error message is sent to standard error. 

See Also 



Ipadmin(ADM), lp(C) 

Authorization 



The use of this utility is govemed by assignment of the Ip authoriza- 
tion, which is usually reserved for system administrators. 
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Ipforms 



administer forms used with the print service 
Syntax 



/usr/Iib/lpforms -f form-name option 

/usr/lib/lpforms -f form-name -A al&n-type [-Q integer i ] [- W 
integer 2] 

/usr/Iib/lpforms -f form-name -A list 
/usr/lib/lpforms -f form-name -A quiet 
/usr/lib/lpforms -f form-name -A none 

Description 



The Ipforms command is used to administer the use of preprinted 
forms, such as company letterhead paper, with the LP print service. 
The first variation of the Ipforms command allows the administrator to 
add, change, and delete forms, to list the attributes of an existing form, 
and to allow and deny users access to particular forms. The second 
variation of Ipforms is used to establish the method by which the 
administrator is alerted that a form must be mounted on a printer. The 
third variation is used to list the current alerting methods assigned to 
forms. The form is specified by the form-name given with the Ipforms 
command. Users may request this form by form-name [see lp(C)]. 
The fourth variation of Ipforms is to terminate an active alert. The 
fifth form is used to remove an alert. 

With the first variation of the Ipforms command, one of the following 
options must be used: 

-F path-name to add or change a form as specified by the information 
in path-name 

To add or change a form, and supply information from 
standard input 

-X to delete a form 

This option must be used separately; it cannot be used 
with any other option. 

-1 to list the attributes of a form 

This option must be used separately; it cannot be used 
with any other option. 
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-u sAlowMser-list 

to allow users to request a form 

This option can be used with the -F or - option. 

-u deny:user-list 

to deny users access to a form 

This option can be used with the -F or - option. 
Each option is explained below. 

Adding or Changing a Form 



The -F path-name option is used to add a new form to the LP print ser- 
vice, or to change the attributes of an existing form. iTie form 
description is taken from path-name if the -F option is given, or the 
standard input if the - option is given. One of the two options must be 
given to define or change a form, path-name is the path name of a file 
Siat contains all or any subset of the following information about the 
form. 

Page length: scaled -decimal -num ber \ 

Page width: scaled -decimal -num ber 2 

Number of pages: integer 

Line pitch: scaled -decimal -number -i, 

Character pitch: scaled -decimal -number 4 

Character set choice: character-setlprint-wheel,[vi\2mA2tiory] 

Ribbon color: ribbon-color 

Comment: 

comment 

Alignment pattern: [content-type] 
content 

Except for the last two lines, the above lines can appear in any order. 
The Comment: and comment items must appear in consecutive order 
but can appear before the other items, and the Alignment pattern: 
and the content items must appear in consecutive order at the end of 
the file. Also, the comment item cannot contain a line that begins with 
any of the key phrases above, unless the key phrase is preceded with a 
">" sign. Any leading > sign found in the comment will be removed 
when the comment is displayed. Case distinctions in the key phrases 
are ignored. 

Upon issuing this command, the form named in form-name is added to 
the list of forms. If the form already exists, its description is changed 
to reflect the new information in tiie input. Once added, a form is 
available for use in a print request, except where access to the form 
has been restricted, as described under the -u allow: option. A form 
may also be allowed to be used on certain printers only. 
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A description of each fomi attribute is below: 

Page length and Page Width 

Before printing ^e content of a print request needing this form, the 
generic interface program provided with the LP print service will 
initialize the physical printer to handle pages 
scaled -decimal -number I long, and scaled -decimal -number 2 
wide using the printer type as a key into the terminfoQF) database. 
A scaled-decimal-number is an optionally scaled decimal number 
that gives a size in lines, columns, inches, or centimeters, as appro- 
priate. The scale is indicated by appending the letter 'i', for 
inches, or the letter 'c', for entimeters. For length or width settings, 
an unsealed number indicates lines or columns; for line pitch or 
character pitch settings, an unsealed number indicates lines per 
inch or characters per inch (the same as a number scaled with 'i'). 
For example, length=66 indicates a page length of 66 lines, 
length=lli indicates a page length of 11 inches, and 
Iength=27.94c indicates a page length of 27.94 centimeters. 

The page length and page width will also be passed, if possible, to 
each filter used in a request needing this form. 

Number of pages 

Each time the alignment pattern is printed, the LP print service 
will attempt to truncate the content to a single form by, if possible, 
passing to each filter the page subset of I -integer. 

Line pitch and Character pitch 

Before printing the content of a print request needing this form, the 
interface programs provided with the LP print service will initial- 
ize the physical printer to handle these pitches, using the printer 
type as a key into the terminfo(F) database. Also, the pitches will 
be passed, if possible, to each filter used in a request needing this 
form. Scaled -decimal -number 2 is in lines per centimeter if a 'c' 
is appended, and lines per inch otherwise; similarly, 
scaled -decimal -number 4 is in columns per centimeter if a *c' is 
appended, and columns per inch otherwise. The character pitch 
can also be given as elite (12 characters per inch), pica (10 charac- 
ters per inch), or compressed (as many characters per inch as pos- 
sible). 

Character set choice 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the print wheel print-wheel should 
be used on those printers that take print wheels. If printing with 
this form is to be done on a printer that has selectable or loadable 
character sets instead of print wheels, the interface programs pro- 
vided with the LP print service will automatically select or load 
the correct character set. If mandatory is appended, a user is not 
allowed to select a different character set for use with the form; 
otherwise, the character set or print wheel named is a suggestion 
and a default only. 
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Ribbon color 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the color of the ribbon should be 
ribbon-color. 

Comment 

The LP print service will display the comment unaltered when a 
user asks about this form [see lpstat(C)]. 

Alignment pattern 

When mounting this form an administrator can ask that the content 
be repeatedly printed, as an aid in correctly positioning the pre- 
printed form. The optional content-type defines the type of printer 
for which content had been generated. If content-type is not given, 
simple is assumed. Note that the content is stored as given, and 
will be readable only by the user Ip. 

When an existing form is changed with this command, items missing 
in the new information are left as they were. When a new form is 
added with this command, missing items will get the following 
defaults: 

Page Length: 66 
Page Width: 80 
Number of Pages: 1 
Line Pitch: 6 
Character Pitch: 10 
Character Set Choice: any 
Ribbon Color: any 
Comment: (no default) 
Alignment Pattern: (no default) 

Deleting a Form 



The -X option is used to delete the form specified in form-name from 
the LP print service. 

Listing Form Attributes 



The -1 option is used to list the attributes of the existing form specified 
hy form-name. The attributes listed are those described under "Add- 
ing and Changing a Form," above. Because of the potentially sensi- 
tive nature of the alignment pattern, only the administrator can exam- 
ine the form with this command. Other people can use the lpstat(C) 
command to examine the non-sensitive part of the form description. 

Allowing and Denying Access to a Form 



The LP print service keeps two lists of users for each form, an allow- 
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list of people allowed to use the form, and a deny-list of people denied 
access to the form. With the -u allow: option, the users listed are 
added to the allow-list and removed from the deny-list. With the 
-u deny: option, the users listed are removed from the allow-list and 
added to the deny-list. 

If the allow-list is not empty, the users in the list are allowed access to 
the form and all others are denied access, regardless of the content of 
the deny-list. If the allow-list is empty, but the deny-list is not, the 
users in the deny-list are denied access and all others are allowed. If 
both lists are empty, all users are allowed access. Access can be 
denied to all users, except the LP print service administrator, by put- 
ting any in the deny-list. To effectively empty both lists, allowing 
access for everyone, put any in the allow-list. 

Alerting to Mount Forms 



The second variation of the Ipforms command is used to arrange for 
the alerting to mount forms on a printer. 

When integer \ print requests needing the preprinted form form-name 
become queued up because no printer satisfying all the needs of the 
requests has the form mounted, and for as long as this condition 
remains, an alert is sent to the administrator every integer 2 minutes 
until the form is mounted on a qualifying printer. If the form-name is 
all, the alerting defined in this command applies to all existing forms. 
No alerting is done for a backlog of print requests needing a form if 
the administrator does not use this option. 

The method for sending the alert depends on the value of the -A 
option. 

write 

The message is sent via write(C) to the terminal on which the 
administrator is logged in when the alert arises. If the administra- 
tor is logged in on several terminals, one is chosen arbitrarily. 

mail 

The message is sent via mail to the administrator who issues this 
command. 

The message sent appears as follows: 

The form form-name needs to be mounted on the printer(s). 

printer- list (integer 2 requests) 

integer 4 print request awaits this form. 

Use the ribbon-color ribbon. 

Use the print-wheel print wheel, if appropriate. 
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The printers listed are those that the administrator had earlier 
specified were candidates for this form. The number ( integer ) 
listed next to each printer is the number of requests eligible for the 
printer. The number ( integer 4 ) shown after the printer list is the total 
number of requests awaiting the form. It will be less than the sum of 
the other numbers if some requests can be handled by more than one 
printer. The ribbon-color and print-wheel are those given in the form 
description. The last line in the message is given even if none of the 
printers listed use print wheels, because the administrator may choose 
to mount the form on a printer that does use a print wheel. 

Where any color ribbon or any print wheel can be used, the statements 
above will read: 

Use any ribbon. 
Use any print-wheel. 

shell-command 

The shell-command is run each time the alert needs to be sent. The 
shell command should expect the message as standard input. Note 
that the mail and write values for the -A command are equivalent 
to the values mail user-name and write user-name, respectively, 
where user-name is the current name for the administrator. This 
will be the login name of the person submitting this command 
unless he or she has used the su command to change to another 
user ID. If the su command has been used to change the user ID, 
then the user-name for the new ID is used. 

If the -Q option is not given or integer 1 is one or the word any (which 
is the default), a message is sent as soon as anyone submits a print 
request for the form when it is not mounted. 

If the -W option is not given or integer 2 is zero or the word once 
(which is the default), only one message is sent when the queue size 
exceeds integer 1 . 

Listing the Current Alert 



The third variation of Ipforms is used to list the type of the alert for the 
specified form. No change is made to the alert. If form-name is recog- 
nized by the LP print service, one of the following lines is sent to the 
standard output, depending on the type of alert for the form. 

When integer are queued: alert with shell-command every integer 
minutes 

When integer are queued: write to user-name every integer minutes 
When integer are queued: mail to user-name every integer minutes 
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No alert 

The phrase every integer minutes is replaced with once if integer 2 
(the -W integer 2 ) is 0. 

Terminating an Active Alert 



The quiet option is used to stop messages for the current condition. 
An administrator can use this option to temporarily stop receiving 
further messages about a known problem. Once the form has been 
mounted and Uien unmounted, messages will again be sent when the 
queue size reaches integer j pending requests. 

Removing an Alert Definition 



No messages will be sent until the none option is given again with a 
different alert-type . This can be used to permanently stop further mes- 
sages from being sent. 

See Also 



lp(C), Ipadmin(ADM), terminfo(F) 

Authorization 



The use of this utility is governed by assignment of the Ip authoriza- 
tion, which is usually reserved for system administrators. 
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Ipsched, Ipshut, Ipmove 



start/stop the print service and move requests 
Syntax 



/usr/Iib/lpsched 
/usr/lib/lpsched -q integer 
/usr/lib/lpsched -a integer 
/usr/lib/lpsched -p integer 
/usr/lib/lpsched -s integer 
/usr/lib/lpshut 

/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

Description 



Ipsched starts the LP print service; this can be done only by root or Ip. 

Ipshut shuts down the print service. All printers that are printing at 
the time Ipshut is invoked will stop printing. When Ipsched is started 
again, requests that were printing at the time a printer was shut down 
will be reprinted from the beginning. 

Ipmove moves requests that were queued by Ip between LP destina- 
tions. The first form of the command moves the named requests to the 
LP destination dest. Requests are request-ids as returned by Ip. The 
second form moves all requests for destination destl to destination 
dest2 ; Ip will then reject any new requests for destl . 

Note that when moving requests, Ipmove never checks the acceptance 
status (see accept (ADM)) of the new destination. Also, the request ID 
of the moved request is not changed so that users can still find their 
requests. The Ipmove command will not move requests that have 
options (content type, form required, and so on) that cannot be handled 
by the new destination. 

-q integer 

Specify the number of request structures you want to allocate, 
-a integer 

Specify the number of alert structures you want to allocate. By 
default, forty empty alert structures are allocated in addition to 
one for each printer or form on the system. Structures will 
always be allocated for existing printers and forms. You can 
choose, however, to have more or fewer than the forty extra, by 
using the -a option. For example, if you want only as many alert 
structures as you have printers and forms on your system, enter 
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the following command: Ipsched -a 0. 
-p integer 

Specify the number of print status structures you want to allo- 
cate. By default, twenty- five empty printer status structures are 
allocated in addition to one for each printer on the system. 
Structures will always be allocated for existing printers. You 
can choose, however, to have more or fewer than the forty extra, 
by using the -p option. 

-s integer 

Specify the number of slow filters per printer that can be run 
simultaneously. 

Notes 



By default, the directory /usr/spool/lp is used to hold all the files used 
by the LP print service. This can be changed by setting the SPOOL- 
DIR environment variable to another directory before running 
Ipsched. If you do this, you should populate the directory with the 
same files and directories found under /usr/spool/lp; the LP print ser- 
vice will not automatically create them. Also, the SPOOLDIR vari- 
able must then be set before any of the other LP print service com- 
mands are run. 

Files 



/usr/spool/lp/* 

See Also 



enable(C), lp(C), Ipstat(C), accept(ADM), Ipadmin(ADM) 

Authorization 



The behavior of this utility is affected by assignment of the Ip authori- 
zation, which is usually reserved for system administrators. 
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Ipsh 

menu driven Ip print service administration utility 
Syntax 

/usr/lib/sysadm/lpsh 

Description 

Ipsh is the screen interface invoked by the sysadmsh(ADM) Printers 
selection to administer the print service. The interface performs all of 
the required Ip print service functions that require system administra- 
tor authorization, Ip. 

The program allows the administrator to perform any of the following 
tasks: 

• configure the LP print service to describe printers and devices. 

• administer filters to be used with the LP print service. 

• administer forms to be used with the LP print service. 

• start the LP print service. 

• shut down the LP print servce. 

• move print requests between printer destination. 

• cancel print requests. 

• allow destinations to accept or reject print requests. 

• set the printing queue priorities that can be assigned to jobs sub- 
mitted by users of the LP print service. 

• enable or disable printers. 

See Also 

auditsh(ADM), authsh(ADM), backupsh(ADM), atcronsh(ADM), 
sysadmsh(ADM), lp(C), Ipadmin(ADM), Ipfilter(ADM), 
Ipforms(ADM), Ipsched(ADM), Ipusers(ADM), accept(ADM), 
enable(C) 



March 22, 1990 



LPSH-1 



LPSH (ADM) 

Notes 



LPSH (ADM) 



Invoking the Ipsh directly is not recommended; use the sysadmsh 
Printers selection. 

Value Added 



Ipsh is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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Ipusers 



set printing queue priorities 
Syntax 



/usr/lib/lpusers -d priority-level 
/usr/lib/lpusers -q priority-level -u user-list 
/usr/Iib/Ipusers -u user-list 
/usr/lib/lpusers -q priority-level 
/usr/lib/lpusers -1 

Description 



The Ipusers command is used to set limits to the queue priority level 
that can be assigned to jobs submitted by users of the LP print service. 

The first form of the command (with -d) sets the system-wide priority 
default to priority-level, where priority -level is a value of 0 to 39, with 
0 being the highest priority. If a user does not specify a priority level 
with a print request [see IpiC)], the default priority is used. Initially, 
the default priority level is 20. 

The second form of the command (with -q and -u) sets the default 
highest priority-level (0-39) that tiie users in user-list can request 
when submitting a print request. Users that have been given a limit 
cannot submit a print request with a higher priority level than the one 
assigned, nor can they change a request already submitted to have a 
higher priority. Any print requests with priority levels higher than 
allowed will be given die highest priority allowed. 

The third form of the command (with -u) removes the users from any 
explicit priority level and returns them to the default priority level. 

The fourth form of the command (with -q) sets the default highest 
priority level for all users not explicitly covered by the use of the 
second form of this command. 

The last form of the command (with -1) lists the default priority level 
and the priority limits assigned to users. 

See Also 



lp(C) 
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displays the list of major device numbers currently 
specified in the mdevice file 

Syntax 



/etc/conf/cf.d/majorsinuse 

Description 



This script searches the mdevice file and displays a list of the major 
device numbers already in use. 

When installing a device driver with the Link Kit, you can use 
majorsinuse to find an available major device number for the driver. 
When you invoke the configure program to modify the system config- 
uration files with the new driver information, use the -m option to 
indicate the major device number of the driver. 

The -j option to configure performs a function similar to that of 
majorsinuse. If you give the -j option with the NEXTMAJOR keyword, 
configure tells you the next available major device number. 

Files 



/etc/conf/cf.d/mdevice 

See Also 



configure(ADM), mdevice(F), "Adding Device Drivers with the Link 
Kit" in the System Administrator's Guide 

Value Added 



majorsinuse is an extension of AT&T System V provided in Altos 
UNIX System V. 
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makekey 



generates an encryption key 
Syntax 



/usr/lib/makekey 

Description 



makekey improves the usefulness of encryption schemes by increasing 
the amount of time required to search the key space. It reads 10 bytes 
from its standard input, and writes 13 bytes on its standard ou^ut. 
The output depends on the input in a way that is intended to be diffi- 
cult to compute (i.e., to require a substantial fraction of a second). 

The first 8 input bytes (the input key) can be arbitrary ASCII charac- 
ters. The last 2 input bytes (the salt) are best chosen from the set of 
digits, dot (.), slash (/), and uppercase and lowercase letters. The salt 
characters are repeated as the first 2 characters of the output. The 
remaining 11 ou^ut characters are chosen from the same set as the 
salt and constitute the output key . 

The transformation performed is essentially the following: the salt is 
used to select one of 4,096 cryptographic machines all based on the 
National Bureau of Standards DES algorithm, but broken in 4,096 dif- 
ferent ways. Using the input key as the key, a constant string is fed 
into the machine and recirculated. The 64 bits that come out are dis- 
tributed into the 66 output key bits in the result. 

See Also 



passwd(F) 
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mkdev 

calls scripts to add peripheral devices 
Syntax 



/etc/mkdev dos 

/etc/mkdev fd 

/etc/mkdev fs [ device file ] 

/etc/mkdev hd [ [ disk ] [ adapt_# ] [ LUN ] [ adapt_type ] ] 
/etc/mkdev mouse 
/etc/mkdev serial 
/etc/mkdev shl 
/etc/mkdev streams 

/etc/mkdev tape [ [ contrllD ] [ adapt_# ] [ LUN ] [ adapt_type ] ] 
/etc/mkdev graphics 



Description 



mkdev creates the device file(s) associated with a peripheral device. 
Based on the argument supplied, the mkdev command calls a script 
found in the directory /usr/lib/mkdev. If no arguments are listed, 
mkdev prints a usage message. The following paragraphs describe 
each of the optional arguments that can be used with mkdev: 

/etc/mkdev dos initializes necessary devices and configures the system 
to support mounted DOS filesystems. 

/etc/mkdev hd creates device files for use with a peripheral hard disk. 
The device files for an internal hard disk already exist, /etc/mkdev hd 
invokes the following utilities: dparam(ADM), fdisk(ADM), and 
diwy(ADM). SCSI disks require four pieces of information: the ID of 
the disk controller, the host adapter number, the LUN (logical unit 
number, which always should be zero), and the host adapter type. 
Thus, you can install SCSI disks with a mkdev hd command contain- 
ing arguments within the following ranges: 

mkdev hd [0-6] [0-3] 0 [ti I hpfp I ad] 

You must invoke mkdev hd twice to install a SCSI disk. The first 
time, the kernel will be reconfigured to support the new disk. The 
second time, the disk will be initialized. Use the same mkdev hd argu- 
ments both times. However, if the kernel has already been configured 
to support the new disk, mkdev hd need only be invoked once to ini- 
tialize the disk. 
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letclmkdev serial creates device files for use with serial cards. The de- 
vice files for the first and second ports already exist. Additional de- 
vice files must be created for the ports added when expansion cards 
are added to the system. 

letclmkdev streams configures the kernel for streams support. 

letclmkdev fs performs the system maintenance tasks required to add 
a new filesystem to the system once the device is created (mknod(C)) 
and the filesystem is made (m)^s(ADM)). It creates the Ifile and 
i(/i/e/lost+found directories, reserves slots in the lost+found directory, 
(if either already exist, they are used unmodified) and modifies 
/etc/checklist, /etc/default/filesys and /etc/default to check 
(fsck(ADM)) and mount {mount(ADMX mnt(C), rc(C)) the filesystem 
as appropriate. It is usually used in conjunction with mkdev hd when 
adding a second hard disk to the system or with mkdev fd when creat- 
ing a mountable filesystem on a floppy, but can be used on any addi- 
tional filesystem (for example, on a large internal hard disk). 

letclmkdev fd creates bootable, root and filesystem floppy disks. 

Several floppies can be created during a single mkdev fd session, but 
mkdev does not display a prompt to remove the first floppy and insert 
the next one. Insert the next floppy when mkdev prompts "Would you 
like to format the floppy first? (y/n)." 

letclmkdev tape configures the tape driver in preparation for linking a 
new kernel that includes tape support. It adds a standard quarter-inch 
cartridge tape driver and/or a mini-cartridge tape driver. 

The current driver configurations can be displayed, and changed if 
necessary. A zero in any of the fields means the driver automatically 
detects tiie type of tape device installed and uses the built-in values 
for that device. If the autoconfiguration values are not correct for your 
drive, refer to your hardware manual for the correct values, configure 
the driver and relink the new kemel. mkdev tape can also be used to 
remove a tape driver from the existing kemel. 

SCSI tapes, such as Exabyte or 9-track, can also be installed using 
letclmkdev tape. Just as with SCSI disks, the adapter type, adapter 
number, and the controller ID must be specified (the LUN should 
always be zero). 

letclmkdev shl initializes necessary devices and configures kemel 
parameters associated with the number of shell layers sessions avail- 
able on the system. 

letclmkdev mouse initializes necessary devices and configures the sys- 
tem to use any supported mouse. 
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Use letclmkdev graphics to up the graphics device (display adapter) 
for the console and any of its virtual terminals. When you invoke 
mkdev graphics, you are placed in a menu-driven interface similar to 
the interface used for sysadmsh{MyM). With these menus you can 
control three basic aspects of the graphics adapter: Adapter Type, 
Adapter Mode (resolution), and affected terminals (Devices). 

The Adapter Type field lists all display devices that are supported by 
the operating system. Select the device currently installed in your 
system (e.g., Orchid Designer VGA). The Adapter Mode associates 
the adapter type with a resolution (via the graflnfo file). The Devices 
field lets you select which virtual terminals will be controlled by this 
adapter type and resolution combination. See multiscreenQA) for 
more information on virtual console terminals. 

A common use of mkdev graphics is to reconfigure your adapter to run 
at a higher resolution, for example when running graphics-intensive 
applications software (such as Open Desktop). However, note that 
you may set your graphics adapter to run only at those resolutions that 
are supported by the grafinfo file, regardless of any additional resolu- 
tions tiie adapter hardware supports. 

Once the driver is configured, you are prompted for re-linking the ker- 
nel. The appropriate devices in /dev are created. 

The various init scripts prompt for the information necessary to create 
the devices. 

Files 



/usr/lib/mkdev/* 
/usrAib/grafinfo/* 

See Also 



badtrk(ADM), divvy(ADM), dparam(ADM), fd(HW), fdisk(ADM), 
filesys(F), format(C), hd(HW), Ip(HW), mkfs(ADM), mknod(C), 
mount(ADM), serial(HW), usemouse(C), tape(HW) 

The System Administrator's Guide has chapters devoted to the instal- 
lation of most peripheral devices. 

Value Added 



mkdev is an extension of AT&T System V provided in Altos UNIX 
System V. 
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mkfs 



constructs a filesystem 
Syntax 



/etc/mkfs [ -y I -n ] [ -f fstype ] special blocks[ : inodes] [gap inblocks] 
/etc/mkfs special proto [gap inblocks] 

XENIX filesystem options 



[-S blocks [ : inodes]] 
UNIX filesystem options 



[-b blocksize] 
AFS filesystem options 



[-C clustersize] 

Description 



mkfs constructs a file system by writing on the special file special , 
according to the directions found in the remainder of the command 
line, ml^s is actually a front-end that invokes the appropriate version 
of mirfs according to the filesystem type. The -f option specifies the 
filesystem type, which can be one of the following: 

AFS (Acer Fast Filesystem) 

S5 IK (UNIX) 

XENIX 

DOS 

The AFS is the default filesystem type. 
Standard Options 



If it appears that the special file contains a file system, operator con- 
firmation is requested before overwriting the data. The -y "y^s" 
option overrides this, and writes over any existing data without ques- 
tion. The -n option causes mkfs to terminate without question if the 
target contains an existing file system. The check used is to read 
block one from the target device (block one is the super-block) and 
see whether the bytes are the same. If they are not, this is taken to be 
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meaningful data and confirmation is requested. 

If the second argument to mkfs is a string of digits, the size of the file 
system is the vdue of blocks interpreted as a decimal number. This is 
the number of physical (512-byte) disk blocks the file system will 
occupy. If the number of inodes is not given, the default is approxi- 
mately the number of logical blocks divided by 4. mkfs builds a file 
system with a single empty directory on it. The boot program block 
(block zero) is left uninitialized. 

If the second argument is the name of a file that can be opened, mkfs 
assumes it to be a prototype file proto, and will take its directions 
from that file. The prototype file contains tokens separated by spaces 
or new-lines. A sample prototype specification follows (line numbers 
have been added to aid in the explanation): 



1 


/ stand/ diskboot 










2 


4872 110 










3 


d— 777 3 1 










4 


usr d— 777 


3 1 








5 


sh 


755 


3 


1 


/bin/sh 


6 


ken 


d~755 


6 


1 




7 




$ 








8 


bO 


b— 644 


3 


1 


0 0 


9 


cO 


c— 644 


3 


1 


0 0 


10 


$ 










11 


$ 











Line 1 in the example is the name of a file to be copied onto block 
zero as the bootstrap program. 

Line 2 specifies the number of physical (512-byte) blocks the file sys- 
tem is to occupy and the number of inodes in the file system. 

Lines 3-9 tell mkfs about files and directories to be included in this 
file system. 

Line 3 specifies the root directory. 

Lines 4-6 and 8-9 specify other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file system it is on, 
and continue from the next higher directory. The $ on lines 10 and 11 
end the process, since no additional specifications follow. 

File specifications give the mode, the user ID, the group ID, and the 
initial contents of the file. Valid syntax for the contents field depends 
on the first character of the mode. 

The mode for a file is specified by a 6-character string. The first char- 
acter specifies the type of the file. The character range is -bed to 
specify regular, block special, character special and directory files, 
respectively. The second character of the mode is either u or - to 
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specify set-user-id mode or not. The third is g or - for the set-group-id 
mode. The rest of the mode is a 3-digit octal number giving the 
owner, group, and other read, write, execute permissions [see 
chmod(l)]. 

Two decimal number tokens come after the mode; they specify the 
user and group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification may be a 
path name from which the contents and size are copied. If the file is a 
block or character special file, two decimal numbers follow which 
give the major and minor device numbers. If the file is a directory, 
mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. As 
noted above, the scan is terminated with the token $. 

The gap inblocks argument in both forms of the command specifies 
the rotational gap and the number of blocks/cylinder. 

XENIX fllesystem options 



The -s option is a command-line override of the size and number of 
inodes in the proto file. 

UNIX fllesystem options 



The -b blocksize option specifies the logical block size for the file sys- 
tem. The logical block size is the number of bytes read or written by 
the operating system in a single I/O operation. Valid values for block- 
size are 512, 1024, and 2048. The default is 1024. A block size of 
2048 may be chosen only if the 2K file system package is installed. If 
the -b option is used, it must appear last on the command line. 

AFS filesystem options 



The -Cclustersize option specifies the cluster size for the filesystem. 
This only applies to AFS; if this is included on the command line, the 
filesystem created will be AFS regardless of the other options used. 

Files 



/etc/vtoc/* 

See Also 



chmod(C), dir(F), filesystem(F) 
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With a prototype file, it is not possible to copy in a file larger than 
64K bytes, nor is there a way to specify links. The maximum number 
of inodes configurable is 65500. 

The directory /etc/fscmd.d/TYPE contains programs for each file sys- 
tem type; mkfs invokes the appropriate binary. 
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mmdf 



routes mail locally and over any supported network 
Description 



The operating system uses MMDF (the Multi-channel Memorandum 
Distribution Facility) to route mail locally and over Micnet, UUCP, or 
other networks that provide MMDF support. The custom utility 
installs MMDF and configures a basic system for sending mail on a 
local machine. 

MMDF is a very versatile and configurable mail routing system. 
MMDF configuration begins with the /usr/mmdf/mmdftailor file, 
which defines the machine and domain names, the various tables 
(alias, domain, channel), and other configuration information. To 
change the configuration of MMDF on your system, you can log in as 
mmcff and edit the configuration files. Whenever you change MMDF 
alias or routing information in any way, you must rebuild the hashed 
database. 

Files 



/usr/mmdf/mmdftailor 
/usr/mmdf/table/ alias.list 
/usr/mmdf/table/alias.user 
/usr/mmdf/table/* .chn 
/usr/mmdf/table/* .dom 

/usr/spool/mail/* 
/usr/spool/mmdf/... 

See Also 



dbmbuild(ADM), mmdfalias(ADM), mnlist(ADM), uulist(ADM), 
tables(F), mmdftailor(F), "Setting Up Electronic Mail" in the System 
Administrator's Guide . 

Value Added 



mmdf is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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mmdfalias 



converts XENIX-style aliases file to MMDF format 
Syntax 



/usr/mmdf/table/tools/ mmdfalias 

Description 



mmdfalias is a conversion utility to produce MMDF-compatible alias 
files from the XENIX-format aliases file, mmdfalias also splits the 
converted contents of /usr/Ilb/mail/aliases into two MMDF files con- 
taining list-type aliases and aliases that map users to machines. 

After installing MMDF with custom, restore /usr/lib/mail/aliases from 
backup tape. Place the following line in the file to indicate where the 
list aliases end and the mapping aliases begin. 

# user-to-machine mapping 

Log in as mmdf and run the /usr/mmdf/table/tools/ mmdfalias conver- 
sion script from the /usr/mmdf/table directory. You now have two 
MMDF files, alias.list and alias.user, in the current directory. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. While logged in as mmdf, run dbmbuild from 
/usr/mmdf/table. 

Files 



/usr/lib/mail/aliases 

/usr/mmdf/table/alias.list 

/usr/mmdf/table/alias.user 

See Also 



dbmbuild(ADM), tables(F), "Setting Up Electronic Mail" in the Sys- 
tem Administrator's Guide 

Value Added 



mmdfalias is an extension of AT&T System V provided in Altos UNIX 
System V. 
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mnlist 



converts a XENIX-style Micnet routing file to MMDF for- 
mat 

Syntax 



/usr/mmdf/table/tools/ mnlist 

Description 



mnlist is a conversion utility to produce MMDF-compatible Micnet 
routing files fi"om the XENDC-format Micnet routing file. 

After installing MMDF with custom, restore /usr/lib/mail/top from 
backup media. Log in as mmdf and run the conversion script 
lusrlmmdfltableltoolsl mnlist from the /usr/mmdf/table directory. You 
now have a Micnet channel file, micnet.chn, in the current directory. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. While logged in as mnidf, run dbmbuild from 
/usr/mmdf/table. 

Files 



/usr/lib/mail/top 
/usr/mmdf/table/micnet.chn 

See Also 



dbmbuild(ADM), tables(F), "Setting Up Electronic Mail" in the Sys- 
tem Administrators Guide 

Value Added 



mnlist is an extension of AT&T System V provided in Altos UNIX 
System V. 
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MOUNT (ADM) 



mounts and unmounts a file structure 
Syntax 



/etc/mount [-r] [-f fstyp] special directory 
/etc/umount special-device 

Description 



mount announces to the system that a removable file structure is 
present on special-device. The file structure is mounted on directory. 
The directory must already exist; it becomes the name of the root of 
the newly mounted file structure, directory should be empty. If direc- 
tory contains files, they will appear to have been removed while the 
special-device is mounted and reappear when the special-device is 
unmounted. 

The mount and umount commands maintain a table of mounted de- 
vices. If mount is invoked without any arguments, it displays the 
name of each mounted device, and the directory on which it is 
mounted, whether the file structure is read-only, and the date it was 
mounted. 

The -f fstyp option indicates that fstyp is the file system type to be 
mounted. If this argument is omitted, it defaults to the root fstyp. 

The optional -r argument indicates that the file is to be mounted 
read-only. Physically write-protected file structures, such as floppy 
disks with write-protect tabs, must be mounted in this way or errors 
occur when access times are updated, whether or not any explicit 
write is attempted. 

umount removes the removable file structure on device special-de- 
vice. Any pending I/O for the file system is completed and the file 
structure is marked as clean. 

Files 



/etc/mnttab Mount table 

/etc/default/filesys Filesystem data 
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See Also 



MOUNT (ADM) 



umount(ADM), mnt(C), mount(S), mnttab(F), (Iefault(F), 
setmnt(ADM) 

Diagnostics 



mount issues a warning if directory does not match the s fname field 
in the superblock of the filesystem to be mounted. The first six char- 
acters in the last component of directory are compared with the name 
in s fname (i.e., mounting a filesystem named spool on /usr/spool 
wori^t cause a warning message, but mounting the same filesystem on 
/mnt will.). 

Busy file structures cannot be dismounted with amount. A file struc- 
ture is busy if it contains an open file or some user's working direc- 
tory. 

Notes 



Only the super-user can use the mount command. 

Some degree of validation is done on the file structure, however it is 
generally unwise to mount corrupt file structures. 

Be warned that when in single-user mode, the commands that look in 
/etc/mnttab for default arguments (for example df, ncheck, quot, 
mount, and umount) give either incorrect results (due to a corrupt 
/etc/mnttab from a non-shutdown stoppage) or no results (due to an 
empty mnttab from a shutdown stoppage). 

When multi-user, this is not a problem; the /etc/rc2 scripts initialize 
/etc/mnttab to contain only /dev/root and subsequent mounts update 
it appropriately. 

The moMnf(ADM) and umount^kJiM) commands use a lock file to 
guarantee exclusive access to /etc/mnttab. The commands which just 
read it (those mentioned above) do not, so it is possible that they may 
hit a window, which is corrupt. This is not a problem in practice since 
mount and umount are not frequent operations. 

When mounting a file system on a floppy disk you need not use the 
same directory each time. However, if you do, the full pathnames for 
the files are consistent with each use. 
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Always unmount filesystems on floppy disks before removing them 
from the floppy drive. Failure to do so requires running fsck the next 
time the disk is mounted . 

The directory /etc/fscmd.d/TTPE contains programs for each file sys- 
tem type; mou/i//umount invokes the appropriate binary. 

Standards Conformance 



mount is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



March 15, 1989 



MOUNT-3 



MOUNTALL (ADM) 



MOUNTALL(ADM) 



mountall, umountall 



mount, unmount multiple file systems 
Syntax 



/etc/mountall [-] [ filesystem-table ] 
/etc/mountall [-a] 
/etc/umountall [ -k ] 

Description 



These commands can be executed only by the super-user. 

The mountall command is used to mount filesystems according to a 
filesystem-table. (/etc/default/filesys is the default filesystem table.) 
The special file name "-" reads from the standard input. 

Before each file system is mounted, it is checked using fsstat(ADM) 
to see if it appears mountable. If the file system does not appear 
mountable, it is checked, using fsck(ADM), before the mount is 
attempted. 

mountall is called with the -a when the system autoboots. The -a flag 
causes output messages to be written to the file /etc/bootlog, and later 
mailed to tihe system administrator (see boot{irW)). 

The umountall command causes all mounted file systems except root 
to be unmounted. 

Files 

Filesystem-table format: 

column 1 block special file name of filesystem 
column 2 mount-point directory 

column 3 "-r" if to be mounted read-only; "-d" if remote 

column 4 (optional) filesystem type string 

column 5+ ignored 

White space separates columns. Lines beginning with "#" are com- 
ments. Empty lines are ignored. 
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A typical filesystem-table might read: 
/dev/dsk/Osl /usr-rS51K 

See Also 

boot(HW), fsck(ADM), fsstat(ADM), mount(ADM), signal(S), 
filesys(F) 

Diagnostics 

No messages are printed if the filesystems are mountable and clean. 

Error and warning messages come from fsck(ADM), fsstat(ADM), and 
mount(ADM). 

Notes 

The information displayed in Column 3 will only appear if the file sys- 
tem was mounted as a read-only or remote resource. 
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mvdir 

moves a directory 

Syntax 

/etc/mvdir dimame newdimame 

Description 

mvdir moves directories within a file system. The directory ( dir- 
name) must be a directory. If there is akeady a directory or file with 
the same name as name, mvdir fails. 

Neither name may be a sub-set of the other. For example, you cannot 
move a directory named /x/y to /x/y/z, and vice versa. 

Notes 



You must be root to use mvdir. 

See Aiso 

mkdir(C) 

Standards Conformance 

mvdir is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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ncheck 

generates names from inode numbers 
Syntax 



ncheck [ -i numbers ] [ -a ] [ -s ] [ filesystem ] 

Description 



ncheck with no argument generates a pathname and inode number list 
of all files on the set of file systems specified in /etc/mnttab. The two 
characters "A" are appended to the names of directory files. 

The options are as follows: 

-i limits the report to only those files whose i-numbers follow. 

-a allows printing of the names . and .., which are ordinarily 
suppressed. 

-s limits the report to special files and files with set-user-ID mode. 
This option may be used to detect violations of security policy. 

A single filesystem may be specified rather than the default list of 
mounted file systems. 

Files 



/etc/mnttab 

See Aiso 



fsck(ADM), sort(C) 

Diagnostics 



When the file system structure is improper, ?? denotes the "parent" 
of a parentless file and a pathname beginning with ... denotes a loop. 
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Notes 

See Notes under moa«/(ADM). 

The directory /etc/fscmd.d/TYPE contains programs for each file sys- 
tem type; ncheck invokes the appropriate binary. 
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netutil 



administers the micnet network 
Syntax 



netutil [option] [ -x ] [ -e ] 

Description 



The netutil command allows the user to create and maintain a network 
of UNIX machines. A Micnet network is a link through serial lines of 
two or more systems. It is used to send mail between systems with the 
mail(C) command, transfer files between systems with the rcp(C) 
command, and execute commands from a remote system with the 
remote (C) command. 

The netutil command is used to create and distribute the data files 
needed to implement the network. It is also used to start and stop the 
network. The option argument may be any one of install, save, 
restore, start, stop, or the numbers 1 through 5 respectively. The -x 
option logs transmissions and the -e options logs errors. The -x and -e 
options work only when they are used in conjunction with start, stop 
or their decimal equivalents (4 and 5). 

The install option interactively creates the data files needed to run the 
network. The save option saves these files on floppy or hard disks, 
allowing them to be distributed to the other systems in the network. If 
you save the micnet files to the hard disk, you can then use uucp{C) to 
transfer the files to the other machines. This option specifies the 
name of the backup device and prompts for whether this is the desired 
device to use. The user can specify an alternate device, including a 
file on the hard disk. The name of the default backup device is 
located in the file /etc/default/micnet. This can be changed depend- 
ing on system configuration. The restore option copies the data files 
from floppy disk back to a system. The start option starts the net- 
work. The stop option stops the network. An option may also be any 
decimal digit in the range 1 to 5. If invoked without an option, the 
command displays a menu from which to choose one. Once an option 
is selected, it prompts for additional information if needed. 

A network must be installed before it can be started. Installation con- 
sists of creating appropriate configuration files with the install option. 
This option requires the name of each machine in the network, the 
serial lines to be used to connect the machines, the speed of transmis- 
sion for each line, and the names of the users on each machine. Once 
created, the files must be distributed to each computer in the network 
with the save and restore options. The network is started by using the 
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start option on each machine in the network. Once started, mail and 
remote commands can be passed along the network. A record of the 
transmissions between computers in a network can be kept in the net- 
work log files. Installation of the network is described in the System 
Administrator's Guide . 

Files 



/bin/netutil 
/etc/default/micnet 

See Also 



mail(C), micnet(F), remote(C), rcp(C), systemid(F), top(F) 

Value Added 



netutil is an extension of AT&T System V provided in Altos UNIX 
System V. 
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nictable 



process NIC database into channel/domain tables 
Syntax 



nictable -[CDT] [-d domain] [-s service] [-t transport] 

Description 



nictable is the tool responsible for taking the hosts.txt table supplied 
by the SRI Network Information Center and creating domain and 
channel tables. 

The -C option causes the program to generate a channel table on the 
standard output. The -D option creates a domain table. This option 
should be combined with the -d option explained below to state which 
domain table you are building. The -T option creates a "top" or 
"rootdomain" table. No trailing domain spec is removed from the 
LHS entry. 

There are several options for further restricting the number of hosts 
chosen. The -d domain option states that only hosts in the domain 
specified should be output. An exception to this is when -d is com- 
bined with -T. In this case, all entries will be output EXCEPT for 
those in the domain specified. The intention is that you grap all of one 
domain with -D, and then grab everybody else with -T. The -s service 
option states that only hosts that are listed as supporting the service 
specified should be output. The -t transport option is like -s except it 
states that only hosts supporting the transport protocol specified 
should be considered. 

Typical usage involves two or three invocations: 



nictable -C < /etc/hosts.txt > smtpchannel 
nictable -D -d ARPA < /etc/hosts.txt > arpadomain 
(and optionally) 

nictable -T -d ARPA < /etc/hosts.txt > rootdomain 

Value Added 



nictable is an extension of AT&T System V provided in Altos UNIX 
System V. 
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nisadmin 



network listener service administration 
Syntax 



nisadmin -x 

nisadmin [ options ] net_spec 

Description 



nisadmin administers the network listener process(es) on a machine. 
Each network has a separate instance of the network listener process 
associated with it; each instance (and thus, each network) is config- 
ured separately. The listener process "listens" to the network for ser- 
vice requests, accepts requests when they arrive, and spawns servers 
in response to those service requests. The network listener process 
will work with any network (more precisely, with any transport pro- 
vider) that conforms to the transport provider specification. 

The listener supports two classes of service: a general listener ser- 
vice, serving processes on remote machines, and a terminal login ser- 
vice, for terminals connected directiy to a network. The terminal log- 
in service provides networked access to this machine in a form suit- 
able for terminals connected directiy to the network. However, this 
direct terminal service requires special associated software, and is 
only available with some networks (for example, the AT&T STARLAN 
network). 

nisadmin can establish a listener process for a given network, config- 
ure the specific attributes of that listener, and start and kill the listener 
process for that network, nisadmin can also report on the listener pro- 
cesses on a machine, either individually (per network) or collectively. 

The following list shows how to use nisadmin. In this list, net_spec 
represents a particular listener process. Specifically, net spec is the 
relative path name of the entry under /dev for a given network (that is, 
a transport provider). Changing the list of services provided by the 
listener produces immediate changes, while changing an address on 
which the listener listens has no effect until the listener is restarted. 
The following combination of options can be used. 

no options will give a brief usage message. 

-X will report the status of all of the listener processes 

installed on this machine. 
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net spec will print the status of the listener process for 

netspec. 

-q net spec will query the status of ±e listener process for the 
specified network, and will reflect the result of that 
query in its exit code. If a listener process is active, 
nhadmin will exit with a status of 0; if no process is 
active, the exit code will be 1; the exit code will be 
greater than 1 in case of error. 

-V net spec will print a verbose report on the servers associated 
with net spec, giving the service code, status, com- 
mand, and comment for each. It also specifies the 
uid the server will run as, and the list of modules to 
be pushed, if any, before the server is started. 



-z service code net spec 

will print a report on the server associated with 
net spec that has service code service code, giving 
the same information as in the -v option. 

-q -z service code net spec 

will query the status of the service with service code 
service code on network net spec, and will exit 
with a status of 0 if that service is enabled, 1 if that 
service is disabled, and greater than 1 in case of 
error. 



-I addr net spec will change or set the address on which the listener 
listens (the general listener service). This is the 
address generally used by remote processes to 
access the servers available through this listener (see 
the -a option, below), addr is the transport address 
on which to listen and is interpreted using a syntax 
that allows for a variety of address formats. By 
default addr is interpreted as the symbolic ASCII 
representation of the transport address. An addr pre- 
ceded by a \x will let you enter an address in hexa- 
decimal notation. Note that addr must appear as a 
single word to the shell and must be quoted if it con- 
tains any blanks. 

If addr is just a dash (-), nlsadmin will report the 
address currently configured, instead of changing it. 

A change of address will not take effect until the 
next time the listener for that network is started. 

-t addr net spec will change or set the address on which the listener 
listens for requests for terminal service, but is other- 
wise similar to the -1 option above. A terminal ser- 
vice address should not be defined unless the appro- 
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priate remote login software is available; if such 
software is available, it must be configured as ser- 
vice code 1 (see the -a option, below). 

-i net spec will initialize or change a listener process for the 
network specified by net spec; that is, it will create 
and initialize the files required by the listener. Note 
that the listener should only be initialized once for a 
given network, and that doing so does not actually 
invoke the listener for that network. The listener 
must be initialized before assigning addressing or 
services. 

[-m] -a service code [-p modules] [-w id] -c cmd -y comment net spec 
will add a new service to the list of services avail- 
able through the indicated listener, service code is 
the code for the service, cmd is the command to be 
invoked in response to that service code, comprised 
of the full path name of the server and its arguments, 
and comment is a brief (free-form) description of the 
service for use in various reports. Note that cmd 
must appear as a single word to the shell, so if argu- 
ments are required, the cmd and its arguments must 
be surrounded by quotes. Similarly, the comment 
must also appear as a single word to the shell. When 
a service is added, it is initially enabled (see the -e 
and -d options below). 

If the -m option is specified, the entry will be 
marked as an administrative entry. Service codes 1 
through 100 are reserved for administrative entries, 
which are those that require special handling inter- 
nally. In particular, code 1 is assigned to the remote 
login service, which is the service automatically 
invoked for connections to the terminal login 
address. 

The -m option used with the -a option indicates that 
special handling internally is required for those 
servers added with the -m set. This internal han- 
dling is in the form of code embedded on the listener 
process. 

If the -p option is specified, then modules will !>e 
interpreted as a list of STREAMS modules for the 
listener to push before starting the service being 
added. The modules are pushed in the order they are 
specified, modules should be a comma- separated 
list of modules, with no white space included. 
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If the option is specified, then id is interpreted as 
the user name from /etc/passwd that the listener 
should look up. From the user name, the listener 
should obtain the user ID, the group ID, and the 
home directory for use by the server. If -w is not 
specified, the default is to use the user ID listen. 

A service must explicitly be added to the listener for 
each network on which that service is to be avail- 
able. This operation will normally be performed 
only when the service is installed on a machine, or 
when populating the list of services for a new net- 
work. 

•r service code net spec 

will remove the entry for the service code from that 
listener's list of services. This will normally be per- 
formed only in conjunction with the de-installation 
of a service from a machine. 

■e service code net spec 

■d service code net spec 

will enable or disable (respectively) the service indi- 
cated by service code for the specified network. 
The service must have previously been added to the 
listener for that network (see the -a option above). 
Disabling a service will cause subsequent service 
requests for that service to be denied, but the pro- 
cesses from any prior service requests that are still 
running will continue unaffected. 



will start and kill (respectively) the listener process 
for the indicated network. TTiese operations will 
normally be performed as part of the system startup 
and shutdown procedures. Before a listener can be 
started for a particular network, it must first have 
been initialized, and an address must be defined for 
the general listener service (see the -i and -1 options, 
above). When a listener is killed, processes that are 
still running as a result of prior service requests will 
continue unaffected. 

The listener runs as user ID root, with group ID sys. A special ID, 
user ID listen and group ID adm, should be entered in the /etc/passwd 
file as a default ID for servers. The listener always uses as its home 
directory /usr/net/nls, which is concatenated with net spec to deter- 
mine the location of the listener configuration information for each 
network. The home directory specified in the /etc/passwd entry for 
listener will used by servers that run as ID listen. 



-s net spec 
-k net spec 
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nlsadmin may be invoked by any user to generate reports, but all 
operations that afifect a listener's status or configuration are restricted 
to the super-user. 

Diagnostics 

If the command is not run under the proper ID, an error message will 
be sent to standard error and the command will terminate. 

Fiies 

/usr/net/nls/nef .spec 

See Aiso 

Network Programmer's Guide 
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pcu 



port configuration utility 
Syntax 



pcu 
pcu -c 

pcu [-q] -d port ... 
pcu [-q] -a port ... 

pcu [-q] [-t term] [-x] [-b baud] port ... 

pcu [-q] [-m modem] [-x] [-b baud] [-s sec] port ... 

pcu [-q] [-p printer] [-b baud] [-n name] [-i model] port 

Description 



The pcu command lets the system administrator configure the tty ports 
on a system. 

When adding a new tty controller board to a system, the system 
administrator should perform the following: 

• Install the board. 

• On EISA systems, run the EISA configuration utility (supplied 
on the ECU diskette that accompanies your system). 

• Run the uconfig(ADM) command, and reboot your system. 

• Create an entry for the controller board in the file 
/etc/card_info, as described in card_info(F). 

• Run pcu(ADM). 
Information Mode 

If used with the -c option, pcu will display the current port assign- 
ments with respect to the EISA boards in the system. 

Visual Mode 

If the user supplies no arguments, pcu will enter visual mode, allowing 
the user to interactively configure ports to contain a variety of de- 
vices. A window displays the current state of each board, or an eight 
port section of a board (if it contains more than eight ports). Each line 
in this window gives information about one port. Various fields on 
this line describe the type of device connected to a port; its baud rate, 
model, and other information as applicable. As the user interacts with 
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pcu, the data displayed in this window will be updated in an immedi- 
ate, "real-time" manner. The changes you propose are displayed in 
the pcu window; however, the actual changes are not implemented 
until you press the Save screen labeled key (F5). 

Batch Mode 

If the user supplies arguments, pcu will execute the requested function 
on one or more specified ports in batch mode. This mode is less flexi- 
ble than interactive visual mode in that only one type of command 
may be given at a time. Changes take effect immediately, and the user 
does not receive any display of the current state of the system's con- 
figuration. Batch mode exists so that ports may be added from shell- 
scripts or by users who know exactly what they want to change and 
prefer to do so from the command line. 

Options 



-c The current port assignments for the EISA boards in the 

system are displayed. 

The following options specify the action and the device type. Other 
options exist to specify the baud rate, timeout, transparent printer 
attachment, printer name, or printer model. If these are missing, they 
are assigned default values appropriate for the type of each device. 
These default values are set up by the system administrator when pcu 
is installed. 

-d The inittab entries for the specified ports will be disabled. 

With the exception of -q, no other options may be 
specified with the -d option. 

-a The inittab entries for the specified ports will be enabled. 

With the exception of -q, no other options may be 
specified with the -a option. 

-t term The specified ports will be changed to support a terminal 
of type term and their /etc/inittab entries will be set to 
respawn. 

-m modem The specified ports will be changed to support a modem 
of type modem and their /etc/inittab entries will be set '^^o 
respawn. Modem may be one of in, out, and bi for dial- 
in, dial-out, and bidirectional, respectively. 

-p printer The specified port will be changed to support a printer of 
type printer and its inittab entry will be set to respawn. 
printer may be either Parallel or Serial. Note that only 
one port may be specified when this option is given. 
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The following options may be specified in conjunction with -t,-m, or 
-p, or they may appear alone (or in combination with each other) to set 
the appropriate fields without changing the device type: 

-b baud Sets the baud rate of the specified ports to baud, where 
baud is a valid gettydefs label. For a printer port, baud 
should be the numeric baud rate value (such as 9600). 

-ssec Sets the number of seconds for the timeout option to 
getty. The -s option is not applicable to printer ports. 

-nname Sets the printer name to name. The -n option is only 
applicable to printer ports. 

-i model Sets the printer model to model. The -i option is only 
applicable to printer ports. 

-X Attaches a transparent printer to the specified terminal or 

modem port. The -x option is not applicable to printer 
ports. For terminal ports, the options -n and -i may also 
be supplied, provided that only one port is specified on 
the command line. A printer is not created for modem 
ports. The user will invoke xprcat(C) to use the tran- 
sparent printer on modem ports. For terminal ports, the 
default for the -i option is the standard Ip interface script. 
The default printer's name is obtained by replacing "tty" 
with "xpr" in the port's ttyname (e.g., port ttyl28 will 
have a transparent printer name of xprl28). 

-q The quiet option is used when pcu is to be run from a 

shell script. It suppresses any interaction with the user 
by assuming answers to questions that the user would 
ordinarily be asked. When the user is changing or delet- 
ing a printer that has requests pending on it, he would 
normally be asked if those requests should be saved or 
moved to another printer. With the -q option the answer 
is assumed to be no for both of these situations. 

Visual Mode 

At any time in visual mode, brief context-sensitive help information is 
available by pressing the question mark key (?) or HELP key (if your 
terminal is so equipped). 

In visual mode, certain letter-keys may be substituted for function- 
keys and arrow-keys. For function-key substitution, use the letter-key 
corresponding to the capital letter in the function-key label displayed 
at the bottom of the pcu screen. For example, use the e letter-key as a 
substitute for the Enable function-key (Fl), or use the f letter-key as a 
substitute for the deFault function-key (F2). For arrow-key substitu- 
tion, the letter-keys h, j, k, and 1 may be used as substitutes for the 
left, down, up, and right arrow-keys, respectively. 
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In visual mode the screen is divided into three areas, which display 
different types of information. The first area is the backplane which is 
a pictorial representation of the back of the machine. Each slot is 
designated by a horizontal line. The currently displayed slot is 
highlighted in reverse video bold. The currently displayed slot may be 
changed with the Prevslot and Nextslot screen labeled keys (F7 and 
F8, respectively). 

The second area is a window which displays the contents of the 
currendy displayed slot. The title bar of this window identifies the 
slot number and the name of the EISA board in that slot. If the name 
of the board is not known, its uncompressed EISA identifier will be 
displayed instead. If the slot is empty, the word NO PORTS will be 
displayed. The interior of this window contains a line for each port on 
that board up to a maximum of eight ports. If the board contains more 
than eight ports, they may be paged through eight ports at a time by 
using the previous page and next page keys. Ports that are turned off 
in the inittab file will have their lines dimmed. Ports may be turned on 
or off via the Enable/Disable screen labeled key (Fl). 

The definition of Fl changes line by line. For lines whose inittab 
entries are already off, Fl invokes the Enable function to turn the entry 
on. If the port is already on, pressing Fl will invoke the Disable func- 
tion to turn it off. Since the currently selected line displays in reverse 
video bold, the user would not be able to tell whether that port is on or 
off without moving off that line, were it not for the fact that the screen 
label of the Fl key contains this information. If the label for Fl is 
Disable, then the port is now on. If the label is Enable, then the port 
must now be off. This window will be empty for boards that are 
unknown (that is, for boards that have no corresponding entry in the 
/etc/card_info file) and for empty slots. If the window contains any 
lines, there will always be a currently selected line which is displayed 
in reverse video bold. 

The currently selected line may be changed by using the up and down 
arrow keys. If the bottom or top of the window is reached and a down 
or up arrow key is pressed, the previous page or next page, if any, will 
be displayed. The currently selected line will be the first or last line of 
the new page. 

Lines may also be marked for use with commands which can affect 
multiple lines. Lines are marked by pressing the Retum key when the 
entire currently selected line is displayed in reverse video bold (that 
is, no fields are selected — see below for a discussion of fields). 
Marked lines are displayed in reverse dim. 

After marking a line the currently selected line is advanced to the next 
line, unless the marked line happens to represent the last port on the 
current board. Lines may be unmarked by pressing retum again while 
the marked line is the currently selected line and no fields are 
selected. 
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The Enable and Disable commands (Fl key) may be used to enable or 
disable all marked lines. If no lines are marked, the command only 
applies to the currently selected line. 

Note that the command shown on the screen label of the Fl key is the 
command applied to all marked lines without regard to whether the 
ports associated with those marked lines are currently on or off. This 
command does not simply toggle the state of the port for each marked 
line. Sometimes two or more /dev entries are aliases which control 
the same hardware port. An example of this is /dev/ttylA and 
/dev/ttyla, which both control the COMl port: the first with modem 
control, the second without. No more than one inittab entry for 
aliased ports may be active at once, pcu ensures this by disallowing 
the user from activating more than one aliased entry at a time. 

The deFault command (F2 key) is used to select or deselect the system 
default printer. The screen label for the F2 key indicates for each 
printer device whether it is currently the system default printer. It 
does this by prefixing the command name, deFault, with an asterisk. 
Pressing F2 when the currently selected line is displaying the system 
default printer deselects it. The printer is unchanged; it is simply no 
longer the system default printer. If a Save command is done at this 
point, then a system default printer is not established. 

Pressing F2 when the currently selected line is displaying a printer 
that is not currently the system default printer selects that printer as 
the new system default printer. Only one system default printer may 
exist on any system, so selecting a system default printer deselects any 
other printer which was previously the system default printer. When 
the currently selected line does not contain a printer, the screen label 
for the F2 key will be blank and pressing F2 will have no effect. 

The Copy command (F3 key) copies the entry on the currently 
selected line to all marked lines. 

The Undo command (F4 key) will undo the proposed changes to any 
marked lines by setting them to the state they were in at the time of 
the last Save command. If no Save command has been given during 
the current invocation of pcu, these lines are set to the values they had 
when pcu was invoked. If the Undo command is given and no lines 
are marked, then any proposed changes to the currently selected line 
are undone. The shifted Undo command (shifted F4 key) will undo all 
changes made to all ports on all board since the last Save or the begin- 
ning of this invocation of pcu. 

Any changes that the user makes in pcu are proposed changes until the 
user issues a Save command by pressing the Save screen labeled key 
(F5) or shift F5, which means save and quit. When pcu saves changes, 
it will update /etc/inittab and execute an 'init q' command. In addi- 
tion, it will kill any gettys or uugettys that are running on changed 
ports. This causes these ports to respawn the getty or uugetty, thus 
effecting any changes to that port, provided that no user is currently 
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logged in to that port. If a user is logged on to a port while pcu is 
changing it, the changes will take effect when the user logs off. 

The user may quit without saving changes by pressing the Quit key 
(F6) or shift F6. Pressing F6 will cause pcu to first check to see if any 
changes have been made that have not yet been saved. If pcu finds 
that changes are pending, it will ask for confirmation. Answering with 
a 'y' or 'Y' (or any response beginning with these letters) followed by 
a carriage return will cause pcu to exit. Any other response will be 
taken to mean 'no' and pcu will continue. To exit immediately 
without saving changes or incurring the confirmation message, press 
shift F6. 

A screen redraw key (ctrl-L) is provided in case the display is 
overwritten by other users writing to your terminal or messages sent to 
the console. 

Each line is divided into several fields which display information 
about the corresponding port. The user proposes changes by altering 
the values of these fields; however, no changes take effect until the 
user issues the Save, or Save and Quit commands described above. 
Fields are selected by using the left and right arrow keys. The 
currently selected field will be displayed in reverse dim. Pressing 
return while a field is selected will bring up the pop-up menu for that 
field. Menu selections may be made by using the up arrow and down 
arrow keys to highlight the desired menu item, then pressing retum to 
select that menu item and close the menu. To exit a menu without 
selecting a menu item, press the escape key. Menus may have more 
than one page. The previous page and next page keys may be used to 
navigate from one menu page to another. In addition, scrolling past 
the bottom or top of a menu page will display the next or previous 
page. Note that navigation in a multipage menu is the same as naviga- 
tion in a multipage window. 

In addition to normal menu selection, some menus allow the user to 
type in a value to be returned by the menu. Such menus have a blank 
line at the bottom of each menu page which cannot be highlighted. 
Any keys other than the arrow keys, escape key, or retum key which 
are pressed by the user will be echoed in this blank line and be 
returned as the selected item when retum is pressed. Any item so 
returned will be subject to validation by pcu. pcu may reject the 
choice or simply warn the user that some action outside of pcu must 
be taken in order for the choice to have the desired effect. 

An a example of this is when the user selects a terminal type that does 
not appear in the menu, pcu will check this selection to ensure that an 
entry by that name has been compiled into the appropriate 
/usr/lib/terminfo/.'' / directory. If no compiled entry is found, pcu will 
inform the user that an entry for that terminal must be compiled with 
tic after exiting pcu. 
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When typing in a new menu item, some basic line editing capabilities 
are provided. The backspace key will delete the last character and 
move the cursor back one space. The left arrow key will move the 
cursor back one space without erasing characters it passes over. The 
right arrow key will move the cursor one space to the right without 
affecting characters it passes over. Text typed at the cursor will be 
inserted at that point and characters to the right of the cursor will be 
pushed further to the right. The delete line key may be used to delete 
all characters on the line and place the cursor on the first character of 
the line. The up arrow and down arrow keys and the previous and next 
page keys retain their normal meanings. Selecting one of these keys 
while inputing a new menu item aborts the new item. As usual, the 
escape key can be used to cancel the menu request. 

If the information in a field is too long to be displayed in that field, the 
shifted right and left arrow keys may be used to scroll horizontally by 
the width of the field to display the remaining text. When the user 
moves off of such a field the field will automatically redisplay the ini- 
tial portion of its text. In pcu, only the baud rate field takes advantage 
of this capability. A baud rate is actually a sequence of baud rates to 
be tried one after the other by getty or uugetty when a user tries to log- 
in. These baud rate sequences are defined as chains of entries in the 
file /etc/gettydefs. The baud rate menu displays the baud rates avail- 
able to a device as the gettydef label of the head of a baud rate 
sequence followed by a colon, followed by a list of baud rates, one for 
each gettydef entry in the chain. The text of a baud rate field is set up 
such that the shifted right or left arrow keys will display the next or 
previous baud rate in the sequence. 

The first field of each line is an unselectable field which displays the 
name of the port it describes. The name of the port is preceded with a 
colon (:) if the port is currently disabled. The second field displays 
the type of the device. For terminals, this is the terminfo name for that 
type of terminal. For modems, the type field may be 'Dial-in', com- 
munication. Dial-in modems use getty to allow users to log in 
remotely, but the computer is not able to dial out through them. Dial- 
in/out modems use uugetty to allow for remote user log-in and to 
allow the computer to dial out to other computers. Dial-out modems 
have their ports disabled so that users cannot log in but they may be 
used to call out to other computers. For a printer, the type field may 
be 'Serial' or 'Parallel. ' 

The third field, the device field, determines the type of device con- 
nected to the port. It may be a terminal, a printer, a modem, or a ter- 
minal or model with a transparent printer attached. Whenever the de- 
vice field is changed the remaining fields in the line will take on the 
default values for that type of device as set up by the system adminis- 
trator (see ''Configuration" below). 

The fourth field is the baud rate field. The baud rate menus may con- 
tain different entries for each device type if the system administrator 
deems some baud rate chains in /etc/gettydefs to be more appropriate 
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for modems than terminals, for example. This configurability can be 
used to reduce the number of menu items in a particular baud rate 
menu (see "Configuration" below). 

The fifth field contains flags to pass to the getty or uugetty commands 
or the name of the printer attached to the port, depending on the type 
of device as selected by field three. For printers, it contains the name 
of the printer. The sixfli field is only used for printers. It contains the 
name of the model file that contains the Ip interface script for that type 
of printer. 

The third area of the screen is the Terminal Cluster Unit (TCU) area. 
The TCU area is located below the ports window and displays a pic- 
torial representation of the TCUs that hang off of a multidrop card. 
This area only displays TCUs if the currently selected slot contains an 
MDC/2 (EISA Multidrop Card). 

TCUs are chained together in increasing order of address. The 
currently selected TCU will be highlighted, with its dip switch set- 
tings, specifing the upper five bits of its address, displayed as a binary 
number. The collection of TCUs may be traversed, a TCU at a time, 
by using the previous page and next page keys. Also the tab key (read 
TCU Advance Block in pcu) may be used to jump over blocks of 
TCUs. The currendy selected TCU and the corresponding page in the 
port window will always match. Changing a page in the port window 
will cause the next or previous TCU in the TCU area to be selected. 
Changing the currently selected TCU with the previous page, next 
page, or tab keys will cause the corresponding page in the port win- 
dow to be displayed. 

Security and Concurrency 



pcu may be run by any user; however, only root and the system 
administrator are allowed to make changes, pcu may be run from 
either single-user or multiuser mode. Multiple copies may be run con- 
currently, but only one of these copies will be permitted to make 
changes at any given time. When multiple copies of pcu are running, 
the first user to make any proposed changes will obtain a lock. All 
other copies of pcu will be prevented from making changes until the 
copy that owns die lock has exited. All other copies will function nor- 
mally except that any attempt to make changes will result in the fol- 
lowing error message: 

others cire changing ports — your pcu is currently read-only 

When the other pcu user exits your pcu will again be able to make 
changes, but a noticeable delay will occur while pcu re-initializes 
itself. Also, if a pcu is started while another is in the process of writ- 
ing a needed file there may be a delay in initialization as the first user 
will have obtained a lock on that file. 
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Users who have write permission for /etc/inittab may make changes 
to this file, and pcu will recognize these changes if a few simple con- 
ventions are followed. First, pcu uses the comment, #MODEM, at the 
end of the entry for a modem in order to avoid imposing an arbitrary 
naming convention on the baud rate labels in /etc/gettydefs. A user 
editing the /etc/inittab file to add a modem should include the com- 
ment, #MODEM, at the end of the entry to inform pcu that the new 
entry describes a modem device. Second, pcu assumes that all non- 
transparent printers will run the command 'Ipset (Parallel I Serial) tty 
baud'. Third, any port names added by editing /etc/inittab must 
match the regexlS) pattern in the /etc/card info entry (see the 
description of /etc/card info below) for the Board on which they 
occur, assuming that such an entry exists in /etc/card_info for this 
board or subfunction. Note that since /etc/inittab is built from files in 
/etc/conf/init.d concatenated to /etc/conf/cf.d/init.base, any changes 
made to /etc/inittab will disappear when an new driver is installed or 
the next time any user of pcu saves changes. 

Configuration 



The system administrator customizes the behavior of pcu by editing 
the files in the /etc/PCU/defauIts directory. The defaults for each de- 
vice type are given in /etc/PCU/defaults/defaults. The /etc/gettydefs 
labels that are displayed in the baud rate menu for each device type 
are given in the files /etc/PCU/defaults/*_labs. The printer models to 
be displayed in the models menu are given in 
/etc/PCU/defaults/models. The names of terminals that are to be dis- 
played in the type menu for terminals are given in 
/etc/PCU/defauIts/term_type. 

The /etc/card_info file contains information on each board that pcu 
will use to determine the name of the board, the types of the ports on 
the board, the number of ports on the board, the driver for that board, 
the assignment of minor numbers, the name pattern for the /dev 
entries. Each entry contains up to seven fields which are separated by 
colons. 

The first field of a card_info entry contains the uncompressed EISA 
identifier for the board (the minor revision level may be omitted). It is 
used to look up the entry for a specific board. For ISA tty controller 
boards, field one contains the word ISA. The second field contains the 
type of the ports on the board or EISA subfunction described by this 
entry. The third entry contains the full name of the board which is dis- 
played for the user in the title bar of the ports window in pcu. 

The fourth field contains a regex(S) pattern to identify the ports that 
belong to this board or subfunction. This regex pattern returns a value 
(usually numeric) that distinguishes one port on the board from the 
next (for example, if the pattern tty([0-9]{2,4})$0 was given the port 
name tty03, the 03 would be returned and regex would succeed). 
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The fifth field contains a printfiS) foimat string for printing a port's 
ttyname, and takes as it's single argument the value returned by the 
regex pattern. For example, the format string tty %02d would be used 
with the regex pattern example given above. 

The sixth and seventh fields are only used by ISA board entries. The 
sixth field contains a range of numbers of the form nl-n2 used as argu- 
ments to the format string in field five to generate ttynames for the 
ports attached to this board. For EISA entries, pcu gets the port range 
for /etc/slot info, which is created by uconfigiADh/^ and its execution 
of pack.d/*7*node scripts. Field seven contains the device driver de- 
vice name for this board as found in the first field of the device 
driver's mdevice(P) file entry. 

Files 



/etc/inittab 

/etc/xprtab 

/etc/gettydefs 

/etc/card_info 

/etc/slot_info 

/etc/PCU/pcu.lockfile 

/etc/PCU/init.d/* 

/etc/PCU/defaults/* 

See Also 



uconfig(ADM), idmkinit(ADM), Ipadmin(ADM), uugetty(ADM), 
tic(C), regcmp(S), regex(S), inittab(F), gettydefs(F), getty(M), 
terminfo(M), eisacfg(HW) 

Owner's Guide (for description of EISA Configuration Utility) 

Diagnostics 



pcu will halt with an exit status of 1 if an error is encountered. An 
exit status of 0 implies success. 

Notes 



pcu requires that the TERM environment variable be set up correctly. 
If this is not the case, pcu may garble the display and render the func- 
tion keys unusable. Since the Quit key could be affected, pcu allows a 
second way to quit without saving changes. If the BREAK key is 
pressed, an interrupt will be sent to pcu which causes it to quit 
immediately. 
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Different terminals support different video attributes, pcu assumes 
that the terminal on which it is run will have at least one of bold or 
dim, and at least one of reverse dim or reverse bold. A selected field 
cannot be highlighted if the second condition is not met, forcing the 
user to count the number of right arrow keystrokes given (or activate 
and cancel a pop-up menu) to see which field the cursor is on. The 
violation of the second condition is a more serious impairment to the 
functionality of pcu. 

pcu is only supported on the following Altos terminals: Altos V, Altos 
VII, Altos 6010, Altos 6160, and the system console (uses ansi 
terminfo entry). The IBM-style keyboard used by the system console 
cannot distinguish between shifted and unshifted left and right arrow 
keys. Users of pcu should use the angle bracket keys ('<' and '>') to 
represent the shifted left and right arrow keys. If a monochrome 
graphics card is used for the system console, pcu users will not be able 
to distinguish reverse dim from reverse bold (see above), since these 
cards support only straight reverse video. 

Value Added 



pcu is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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profiler: prfld, prfstat, prfdc, prfsnap, 
prfpr 

UNIX system profiler 

Syntax 



/etc/prfld [ system_namelist ] 
/etc/prfstat on 
/etc/prfstat off 

/etc/prfdc file [ period [ off_hour ] ] 
/etc/prfsnap file 

/etc/prfpr file [ cutoff [ system_namelist ] ] 

Description 



The prfld, prfstat , prfdc , prfsnap , and prfpr routines form a system of 
programs to facilitate an activity study of the operating system. 

The prfld program is used to initialize the recording mechanism in the 
system. It generates a table containing the starting address of each 
system subroutine as extracted from system namelist . 

The prfstat program is used to enable or disable the sampling mecha- 
nism. Profiler overhead is less than 1% as calculated for 500 text 
addresses. Prfstat will also reveal the number of text addresses being 
measured. 

The prfdc and prfsnap programs perform the data collection function 
of the profiler by copying the current value of all the text address 
counters to a file where the data can be analyzed. Prfdc will store the 
counters into file every period minutes and will turn off at off hour 
(valid values for ojf hour are 0-24). Prfsnap collects data at the time 
of invocation only, appending the counter values to file . 

The prfpr program formats the data collected by prfdc or prfsnap. 
Each text address is converted to the nearest text symbol (as found in 
system namelist ) and is printed if the percent activity for that range is 
greater than cutoff. 

Flies 



/dev/pri interface to profile data and text addresses 

/unix default for system namelist file 
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proto 



prototype job file for at, cron and batch 
Syntax 



/usr/lib/cron/.proto 
/usr/lib/cron/.proto.^MeMe 

Description 



When a job is submitted to at(C) or batchiC), the job is constructed as 
a shell script. First, a prologue is constructed, consisting of: 

• A header whether the job is an at job or a batch job (actually, at 
jobs submitted to all queues other than queue a, not just to the 
batch queue b, are listed as batch jobs); the header will be 

: at job 
for an at job, and 

: batch job 
for a batch job. 

• A set of Bourne shell commands to make the environment (see 
environ{5)) for the job the same as the current environment; 

• A command to run the user's shell (as specified by the SHELL 
environment variable) with the rest of the job file as input. 

At then reads a prototype file, and constructs the rest of the job file 
from it. 

Text from the prototype file is copied to the job file, except for special 
variables that are replaced by other text: 

$d is replaced by the current working directory 

$1 is replaced by the current file size limit (see ulimit(2)) 

$m 

is replaced by the current umask (see umask(2)) 
$t is replaced by the time at which the job should be run, 
expressed as seconds since January 1, 1970, 00:00 Greenwich 
Mean Time, preceded by a colon 
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$< is replaced by text read by at from the standard input (that is, 
the commands provided to at to be run in the job) 

If the job is submitted in queue queue, at uses the file 
/usr/lib/croii/.proto.9U£ue as the prototype file if it exists, otherwise it 
will use the file /usr/lib/cron/.proto. 

Examples 



The standard .proto file supplied is: 

#ident "@ (#) adm: .proto 1.2" 

cd $d 

ulimit $1 

umask $m 

$< 

which causes commands to change the current directory in the job to 
the current directory at the time at was run, to change the file size 
limit in the job to the file size limit at the time at was run, and to 
change the umask in the job to the umask at the time at was run, to be 
inserted before the commands in the job. 

Files 



/usr/lib/cron/.proto 
/usr/lib/croii/.proto.^MeMe 

See Also 



at(C), sysadmsh(ADM), atcronsh(ADM) 
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rcO 



run commands performed to stop the operating sys- 
tem 

Syntax 



/etc/rcO 

Description 



This file is executed at each system state change that needs to have 
the system in an inactive state. It is responsible for those actions that 
bring the system to a quiescent state, traditionally called "shutdown." 

One system state requires this procedure: state 0 (the system halt 
state). Whenever a change to this state occurs, the letclrcO procedure 
is run. The entry in /etc/inittab might read: 

sO :0 :wait : /etc/rcO >/dev/console 2>&1 </dev/console 

Some of the actions performed by letclrcO are carried out by files in 
the directory /etc/shutdown.d and files beginning with K in 
/etc/rcO.d. These files are executed in ASCII order (see Files below 
for more information), terminating some system service. The combi- 
nation of commands in letclrcO and files in /etc/shutdown.d and 
/etc/rcO.d determines how the system is shut down. 

The recommended sequence for letclrcO is: 

Stop System Services and Daemons. 

Various system services (such as Remote File Sharing or LP 
Spooler) are gracefully terminated. 

When new services are added that should be terminated when the 
system is shut down, the appropriate files are installed in 
/etc/shutdown.d and /etc/rcO.d. 

Terminate Processes 

SIGTERM signals are sent to all running processes by 
killall (ADM). Processes stop themselves cleanly if sent 
SIGTERM. 
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Kill Processes 

SIGKILL signals are sent to all remaining processes; no process 
can resist SIGKILL. 

At this point the only processes left are those associated with 
letclrcO and processes 0 and 1, which are special to the operating 
system. 

Unmount All File Systems 

Only the root file system (/) remains mounted. 

Files 

The execution by /bin/sh of any files in /etc/shutdown.d occurs in 
ASCII sort-sequence order. See rc2 (ADM) for more information. 

See Also 

killall(ADM), rc2(ADM), shutdown(ADM) 
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rc2 



run commands performed for multiuser environment 
Syntax 



/etc/rc2 

Description 



This file is executed via an entry in /etc/inittab and is responsible for 
those initializations that bring the system to a ready-to-use state, tradi- 
tionally state 2, called the "multiuser" state. 

The actions performed by letclrcl are found in files in several direc- 
tories and are executed in a prescribed order to ensure proper initial! - 
zation. Ietclrc2 performs the following functions in the order in which 
they appear: 

1. Runs the script letclconflbinlidmkenv . This script sets up the 
new kernel environment if a new kernel has been configured, 
calls idmkinit to rebuild the /etc/inittab file, and links files to 
the /etc/idrc.d and /etc/idsd.d directories to be run by letclrcl . 

2. Runs the system setup scripts in the directory /etc/rc2.d. Some 
of the scripts in this directory are front-end scripts to run other 
scripts in the subdirectories of /etc/red. 

3. Runs system setup scripts in the directory /etc/red. This direc- 
tory exists for XENIX compatibility. It contains subdirectories 
named with the numerals 0 to 9. Each subdirectory contains 
scripts that perform certain system startup functions (for exam- 
ple, the directory /etc/rc.d/3 contains scripts that handle crash 
recovery). All of these scripts are run by the front-end scripts 
in /etc/rc2.d. Any other individual scripts in the directory are 
run. 

4. Runs the system setup scripts in the directory /etc/idrc.d, 
which contains scripts from the driver packages linked from 
/etc/conf/rc.d. 

5. Runs the scripts in /etc/idsd.d, which contains shutdown scripts 
linked from ^tc/conf/sd.d. 

6. Runs the script /etc/rc. This script exists for XENIX compati- 
bility. It is an empty file, but you can add initialization com- 
mands to the file. These commands are run last during the ini- 
tialization. 
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The setup scripts are executed by /bin/sh in ASCII sort-sequence order 
(see Files for more information). When functions are added that need 
to be initialized when the system goes multiuser, an appropriate file 
should be added in /etc/rc2.d. 

Other functions can be added, as required, to support the addition of 
hardware and software features. 

Examples 



The following are prototypical files found in /etc/rc2.d. These files 
are prefixed by an S and a number indicating the execution order of 
the files. 

MOUNTFSYS 



# Set up and mount file systems 
cd / 

/etc/mountall 

uucp 

# clean-up uucp locks, status, and temporary files 
rm -rf /usr/spool/locks/* 

Ietclrc2 also sets certain environment variables, including the TZ vari- 
able by reading /etc/TIMEZONE , thus establishing the default 
environment for all commands that follow. 

Files 



Here are some hints about files in /etc/rc.d: 

The order in which files are executed is important. Since they are 
executed in ASCII sort-sequence order, the first character of the file 
name is a sequence indicator that helps keep the proper order. Thus, 
files starting with the following characters would run accordingly: 

[0-9] very early 
[A-Z] early 
[a-n] later 
[o-z] last 

Files in /etc/rc.d that begin with a dot (.) will not be executed. This 
feature can be used to hide files that are not to be executed for the 
time being without removing them. The command can be used only 
by the super-user. 
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Files in /etc/rc2.d must begin with an S or a K followed by a number 
and the rest of the file name. Upon entering run level 2, files begin- 
ning with S are executed with the start option; files beginning with K 
are executed with the stop option. Files beginning with other charac- 
ters are ignored. 

See Also 



shutdown(ADM), init(M), "Starting and Stopping the System" 
chapter of the System Administrator's Guide 
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reduce 



perform audit data analysis and reduction 
Syntax 



reduce [ -s session ] [ -p selection file ] 

Description 



reduce perfonns selective audit data reduction on compacted audit 
output files which were written by the audit daemon. Each audit 
record fi-om the compaction files is examined during reduction to see 
if it meets the selectivity criteria established by the Audit Administra- 
tor. If so, the record is formatted and output to standard output. 

Reduction is performed on all files written by the audit daemon during 
a specified boot session. Each time the Audit subsystem is enabled 
and disabled, a new session number is generated and this is used to 
stamp the filenames generated during that session so that they are 
easily recognizable, 'nie audit daemon records each filename that it 
writes compacted data to in a log file. The log file is always written to 
the secure directory, /tcb/flles/audit. Each session log file is uniquely 
named with the prefix CAFLOG. followed by the session number. 
Thus by specifying a session number for reduction, reduce is able to 
locate the log file and read it to determine certain setup parameters 
and the list of input files to be reduced. 

Data is reduced based on a set of input selection criteria that governs 
the selection of records for printing. Records may be selected based on 
event types, time of event occurrence, user ID of record, group ID of 
record, or by specific object type. To selectively reduce, 
auditsh(^hDM) is used to set up the audit selection file. This file is 
then specified to reduce upon invocation. Time interval selection 
allows for records to be selected only if they occurred within a certain 
time period. Event type selection allows records to be selected only if 
the specified event type is desired. Both user ID and group ID selec- 
tion allows records tiiat were generated by certain users or groups to 
be selected. Lastly, object selection applies to those record types 
referring to a specific file. Some records refer to multiple files and a 
single match for those record types will result in the record being 
selected. Time and event type selection always takes precedence over 
user/group ID and object selection (e.g. if a record has an event type 
that is not selected but the user ID is, the record will be discarded). If 
a record is selected based on time and event type, if any of user ID, 
group ID, or object matches a field in the record, the record is 
selected. If only time and event types are specified, all records of 
matching event types in the interval are selected. If only event type 
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selection is requested, all matching events are selected from every 
record produced in that session, (e.g. If the event mask enables selec- 
tion for all events and no time interval is specified, all records will be 
output) 

The format of the reduced data varies on the type of event being pro- 
cessed. Each record will include the process ID of the process being 
audited, the date and time of the event, the type of audit event, an 
indication of success or failure for the event, and if applicable, object 
names that were accessed. 



Items that are displayed for events include the following: 



Process ID The process ID of the process that generated the audit 
record. 



User IDs The login user ID, effective user ID, real user ID, 
effective group ID, and the real group ID are output for 
the process generating the audit record. 

Date/Time Each audit record is time stamped at generation time. 

The time value is formatted to produce a date/time 
string similar to that printed by ctime(S). 

Event Type Each audit record is classified into a certain event 
depending on what type of system call was performed 
or what type of action was taken by a trusted applica- 
tion. 



Action Many event types are broad categories into which cer- 

tain actions are classified. The reduction program 
makes use of other data in the record to provide further 
discrimination between process actions that fall into 
the category. For system calls, the actual system call 
audited is output. For applications, a more specific 
action identifier is provided. 

Object(s) Many events involve files or special devices which are 
classified as objects. The name of the objects affected 
by process actions are recorded for data reduction. 
Depending on the event and action type, some output 
records may include one or more object names. 

Modes For certain event types, the modes of a file or IPC 

object may be modified. For these records, the old and 
new values of the owner, group, and the object mode 
are displayed. 

Usemame Some events are user account oriented such as login 
and logoff as well as certain administrative functions. 
These output records include the usemame of the 
account that was responsible for the audited action. 
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Result Each output record carries an indicator of whether the 

action was successful or not. Unsuccessful actions are 
sometimes more important that successful ones since 
they may indicate attempts to penetrate the system. For 
system calls that fail, the specific error number and 
error message is output. For applications, an error mes- 
sage describing the failure is output. 

See Also 



auditsh(ADM), auditd(ADM), audit(HW), "Maintaining System 
Security," chapter of the System Administrator's Guide 

Diagnostics 



upon successful completion, the program exits with status 0. 

Value Added 



reduce is an extension of AT&T System V provided in Altos UNIX 
System V. 
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rename login entry to show current layer 
Syntax 



/usr/lib/layersys/ relogin [-s] [line] 

Description 



The relogin command changes the terminal line field of a user's 
utmp(F) entry to the name of 3ie windowing terminal layer attached to 
standard input. write(C) messages sent to 3iis user are directed to this 
layer. In addition, the who(C) command will show the user associated 
with this layer. The relogin command may only be invoked under 
layers(C). 

relogin is invoked automatically by layers(C) to set the utmp(¥) entry 
to the terminal line of the first layer created upon startup and to reset 
the utmp(F) entry to the real line on termination. It may be invoked by 
a user to designate a different layer to receive write{C) messages. 

-s Suppress error messages. 

line Specifies which utmp(F) entry to change. The utmp(P) file 
is searched for an entry with the specified line field. That 
field is changed to the line associated with the standard 
input. To learn what lines are associated with a given user, 
say j doe, enter: 

ps -f -u jdoe 

and note the values shown in the TTY field [see p^(C)]. 

Fiies 



/etc/utmp data base of users versus terminals 

Diagnostics 



Returns 0 upon successful completion, 1 otherwise. 
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See Also 
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layers(C), mesg(C), ps(C), who(C), write(C), utmp(F) 

Notes 

If line does not belong to the user issuing the relogin command or 
standard input is not associated with a terminal, relogin will fail. 
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removepkg 

remove installed package 
Syntax 

removepkg [software_package] 

Description 



The removepkg command will remove the AT&T-style software pack- 
age specifi^ as an argument to removepkg or will remove the soft- 
ware package the user selects if no argument is given to removepkg. 

If an argument is specified, removepkg will search the list of previ- 
ously installed packages and remove the first name it matchs. If no 
name is matched, the user is given an error message. 

If no argument is specified, removepkg will query the user, via a 
menu, which package to remove. 

Notes 

You must invoke removepkg on the console. 

This command does not work on packages installed with 
custom(ADM). 

See Also 



displaypkg(ADM), installpkg(ADM) 
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restore 



UNIX incremental filesystem backup restore 
Syntax 



restore [ -c ] [ -i ] [ -o ] [ -t ] [ -d device ] [ pattern [pattern] . . . ] 

Description 



This utility acts as a front end to cpio(C), and thus reads cpio format 
tapes or floppies. This utility should only be used to restore backups 
made with the AT&T backup(ADM) utility, not xbackup(ADM). 

-c complete restore. All files on the tape are restored. 

-i gets the index file off of the medium. This only works when the 
archive was created using backup. The output is a list of all the 
files on the medium. No files are actually restored. 

-o overwrite existing files. If the file being restored already exists it 
will not be restored unless this option is specified. 

-t indicates that the tape device is to be used. MUST be used with 
the -d option when restoring from tape. 

-d <device> is the raw device to be used. It defaults to 
/dev/rdsk/fOql5d (the 1.2M floppy). 

When doing a restore, one or more patterns can be specified. These 
patterns are matched against the files on the tape. When a match is 
found, the file is restored. Since backups are done using full path- 
names, the file is restored to its original directory. Metacharacters can 
be used to match multiple files. TTie patterns should be in quotes to 
prevent the characters from being expanded before they are passed to 
the command. If no patterns are specified, it defaults to restoring all 
files. If a pattern does not match any file on the tape, a message is 
printed. 

When end of medium is reached, the user is prompted for the next 
media. The user can exit at this point by entering "q". (This may 
cause files to be corrupted if a file happens to span a medium.) In gen- 
eral, quitting in the middle is not a good idea. 

If the file akeady exists and an attempt is made to restore it without 
the -o option, the file name will be printed on the screen followed by a 
question mark. This file will not be restored. 
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In order for multi-volume restores to work correctly, the raw device 
MUST be used. 

See Also 

sh(C) 
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rmail 



submit remote mail received via UUCP 
Syntax 



rmail user ... 

Description 



rmail interprets incoming mail received via uucp(C), passing the pro- 
cessed mail on to submit (ADM) for processing by the MMDF mail 
system, rmail is explicitly designed for use with UUCP and the 
MMDF submit program. It is not intended for use by regular users. 

Rmail performs several conversions on the incoming mail before cal- 
ling submit. The conversions change addresses from the UUCP rout- 
ing style (lists of hosts separated by the character '!') to the domain 
style of address used within the MMDF mail system. The incoming 
message is dealt with in the following manner: 

1) The initial "From" (or ">From") line is processed to discover the 
originating site and the sender of the message. Some UUCP 
mailers do not supply this information as part of the message body. 
If the originating site cannot be found from this information, the 
program environment is inspected for the variable "ACCTSYS"; 
this is set to the originating system by some implementations of 
UUCP. The originating system is used as a table lookup value into 
the mmdf table "rmail.chans," the file contains site/channel pairs. 
If a match is found the resulting channel is used for the submit 
phase. The default UUCP channel is used if no match is found. 
The default channel name is specified in conf.c source and can be 
runtime tailored. Typically it is "uucp". The existence of this 
channel is MANDATORY to prevent dropping mail from unknown 
hosts. 

2) The body of the message is inspected looking for any header lines 
containing addresses; the lines are "From:", "To:", "Cc:", 
"Bcc:" and "Sender:". By scanning the address chains, the 
addresses in these lines are converted into "user(2)known- 
site.domain" form using the MMDF tables to evaluate whether the 
mailer knows the site. For this to work properly, the unqualified 
name of all sites should exist in the appropriate domain tables. 
The scanning stops when an unknown site is discovered and a com- 
posite address will be created. The "From:" line is treated spe- 
cially to preserve any comment information which may have been 
inserted by the originating mailer. 
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3) The 'Date:' line is also re- written into ARPA standard form. 

Before submit is called, the message is re-written into RFC822/733 
form with all addresses obeying 5ie appropriate convention. Any 
missing header lines are supplied. The destination address for the 
message is taken from the argument to rmail , and so the header re- 
writing which is done does not affect the routing of the message. 

See Also 



mail(C), uucp(C), submit(ADM) 
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routines 



finds driver entry points in a driver object module 
Syntax 



/etc/conf/cf.d/routines file.o ... 

Description 



routines searches each of the specified object modules for the names 
of routines used in the device driver and displays them on the screen 

This script is used when installing a device driver with the Link Kit. 
Write down the names produced by routines, then sort through the 
names to determine the interrupt priority level (the highest number 
following the spl prefix) and the relevant configurable driver routines 
(the collection of routines with a common prefix and the suffixes 
open, close, read, write, ioctl, startup, exit, fork, exec, init, halt, poll, 
strategy, print, tty, or intr). 

When you invoke the configure program to modify the system config- 
uration files with the new driver information, you provide the interrupt 
priority level with the -1 option and the relevant routine names with 
the -a option. 

See Also 



configure(ADM), mdevice(F), ''Adding Device Drivers with the Link 
Kit' ' in the System Administrator's Guide 

Value Added 



routines is an extension of AT&T System V provided in Altos UNIX 
System V. 
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runacct 



run daily accounting 

Syntax 

/usr/Iib/acct/runacct [mmdd [state]] 

Description 



runacct is the main daily accounting shell procedure. It is normally 
initiated via cron(C). runacct processes connect, fee, disk, and pro- 
cess accounting files. It also prepares summary files for prdaily or 
billing purposes, runacct is distributed only to source code licensees. 

runacct takes care not to damage active accounting files or summary 
files in the event of errors. It records its progress by writing descrip- 
tive diagnostic messages into active. When an error is detected, a 
message is written to /dev/console, mail [see wai7(C)] is sent to 
root and adm, and runacct terminates, runacct uses a series of lock 
files to protect against re-invocation. The files lock and lockl are 
used to prevent simultaneous invocation, and lastdate is used to 
prevent more than one invocation per day. 

runacct breaks its processing into separate, restartable states using 
statefile to remember the last state completed. It accomplishes this 
by writing the state name into statefile. runacct then looks in sta- 
tefile to see what it has done and to determine what to process next. 
States are executed in the following order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date 
changes if necessary. 

CONNECTl Produce connect session records in ctmp.h format. 

C0NNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct.h 
format. 



MERGE Merge the connect and process accounting 

records. 



FEES Convert output of chargefee into tacct.h format 

and merge with connect and process accounting 
records. 
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DISK 



Merge disk accounting records with connect, pro- 
cess, and fee accounting records. 



MERGETACCT 



Merge the daily total accounting records in day- 
tacct with the summary total accounting records 
in /usr/adm/acct/sum/tacct. 



CMS 



Produce command summaries. 



USEREXIT Any installation-dependent accounting programs 
can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnos- 
tics, then fix up any corrupted data files such as pacct or wimp. The 
lock files and lastdate file must be removed before runacct can be res- 
tarted. The argument mmdd is necessary if runacct is being restarted, 
and specifies the month and day for which runacct will rerun the 
accounting. Entry point for processing is based on the contents of 
statefile; to override this, include the desired state on the command 
line to designate where processing should begin. 

Examples 



To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 



/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acc^ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acc^^nite/daytacct 

/usr/adm/acct/niteAock 

/usr/adm/acct/nite/lock 1 

/usr/adm/acct/niteAastdate 

/usr/adm/acc Vnite/state file 

/usr/adm/acct/nite/ptacct * .mmdd 
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See Also 
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acct(ADM), acctcms(ADM), acctcom(C), acctcon(ADM), 
acctmerg(ADM), acctprc(ADM), acctsh(ADM), cron(C), 
fwtmp(ADM), mail(C), acct(S), acct(F), utmp(F) 

Notes 



Normally, it is not a good idea to restart runacct in the SETUP state . 
Run SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last placet file 
because it will not be complete. 

Standards Conformance 



runacct is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 
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sag 



system activity graph 
Syntax 



sag [ options ] 

Description 



The sag command graphically displays the system activity data stored 
in a binary data file by a previous sar(ADM) run. Any of the sar data 
items may be plotted singly, or in combination; as cross plots, or 
versus time. Simple arithmetic combinations of data may be speci- 
fied. The sag command invokes sar and finds the desired data by 
string-matching the data column header (run sar to see what is avail- 
able). These options are passed through to sar: 

-s time Select data later than time in the form hh[:mm]. Default 
is 08:00. 

-e time Select data up to time . Default is 18:(X). 

-i sec Select data at intervals as close as possible to sec seconds. 

-f file Use file as the data source for sar. Default is the current 
daily data file /usr/adm/sa/sa^. 

Other options: 

-T term Produce output suitable for terminal term. See tplot(ADM) 
for known terminals. Default for term is $TERM. 

-X spec X axis specification with spec in the form: 
"name [op name] . . . [lo hi]" 

-y spec y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, e.g., 
r+w/s[dsk-l], or an integer value. Op is + - * or / surrounded by 
blanks. Up to five names may be specified. Parentheses are not recog- 
nized. Contrary to custom, + and - have precedence over 
* and /. Evaluation is left to right. Thus A / A + B * 100 is 
evaluated (A/(A+B))*100, and A + B / C + D is (A+B)/(C+D). Lo 
and hi are optional numeric scale limits. If unspecified, they are 
deduced from the data. 
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A single spec is permitted for the x axis. If unspecified, time is used. 
Up to 5 specks separated by ; may be given for -y. Enclose the -x and 
-y arguments in " " if blanks or \<CR> are included. The -y default is: 

-y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + %wio 0 100" 

Examples 



To see today's CPU utilization: 
sag 

To see activity over 15 minutes of all disk drives: 

TS=date +%H:%M 

sar -o tempfile 60 15 

TE=date +%H:%M 

sag -f tempfile -s $TS -e $TE -y "r+w/s [dsk] " 

Files 



/usr/adm/sa/sa<iy daily data file for day dd. 

See Also 



sar(ADM), tplot(ADM) 
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system activity report package 
Syntax 



sar [ -ubdycwaqvmnprDS AC ] [ -o file ] t [ n ] 

sar [ -ubdycwaqvmnprDS AC ] [-s time] [-e time] [-i sec] 
[-ffile] 

/usrAib/sa/sadc [t n] [ ofile ] 
/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvmnprDS AC] [-s time ] [-e time ] [-i sec ] 

Description 



sar, in the first instance, samples cumulative activity counters in the 
operating system at n intervals of t seconds, where t should be 5 or 
greater. If the -o option is specified, it saves the samples in file in 
binary format. The default value of n is 1. In the second instance, 
with no sampling interval specified, sar extracts data from a previ- 
ously recorded file, either the one specified by the -f option or, by 
default, the standard system activity daily data file /usr/adm/sa/sad^ 
for the current day dd. The starting and ending times of the report can 
be bounded via the -s and -e time arguments of the form hh[:mm[:ss'\\. 
The -i option selects records at sec second intervals. Otherwise, all 
intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

-u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle - portion of time running in user 
mode, running in system mode, idle with some process waiting 
for block I/O, and otherwise idle. When used with -D, %sys is 
split into percent of time servicing requests from remote ma- 
chines (%sys remote) and all other system time (%sys local). 

-b Report buffer activity: 

bread/s, bwrit/s - transfers per second of data between system 

buffers and disk or other block devices; 

Iread/s, Iwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, i. e., (l-bread/kead) as a 

percentage; 

pread/s, pwrit/s - transfers via raw (physical) device mechanism. 
When used with -D, buffer caching is reported for locally- 
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mounted remote resources. 

-d Report activity for each block device, e. g., disk or tape drive. 
When data is displayed, the device specification dsk- is gen- 
erally used to represent a disk drive. The device specification 
used to represent a tape drive is machine dependent. The 
activity data reported is: 

%busy, avque - portion of time device was busy servicing a 
transfer request, average number of requests outstanding during 
that time; 

r+w/s, blks/s - number of data transfers from or to device, num- 
ber of bytes transferred in 512-byte units; 
avwait, avserv - average time in ms. that transfer requests wait 
idly on queue, and average time to be serviced (which for disks 
includes seek, rotational latency, and data transfer times). 

-n Report name cache statistics. The activity reported is: 
c_hits, cmisses - number of name cache hits and misses; 
hit% - the hit ratio as a percentage. 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s - input character rate, input character 
rate processed by canon, output character rate; 
rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem inter- 
rupt rates. 

-c Report system calls: 

scall/s - system calls of all types; 
sread/s, swrit/s, fork/s, exec/s - specific system calls; 
rchar/s, wchar/s - characters transferred by read and write sys- 
tem calls. When used with -D, the system calls are split into 
incoming, outgoing, and strictly local calls. 

-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswol/s - number of transfers and 
number of 512-byte units transferred for swapins and swapouts 
(including initial loading of some programs); 
pswch/s - process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time 
occupied: 

runq-sz, %runocc - run queue of jH-ocesses in memory and runn- 
able; 

swpq-sz, %swpocc - swap queue of processes swapped out but 
ready to run. 

-V Report status of process, inode, file tables: 

text-sz, proc-sz, inod-sz, file-sz, lock-sz - entries/size for each 
table, evaluated once at sampling point; 
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ov - overflows that occur between sampling points for each 
table. 

-m Report message and semaphore activities: 
msg/s, sema/s - primitives per second. 

-p Report paging activities: 

vfl^s - address translation page faults (valid page not in mem- 
ory); 

pflt/s - page faults from protection errors (illegal access to page) 
or "copy-on-writes"; 

pgfil/s - vflt/s satisfied by page-in from file system; 
rclm/s - valid pages reclaimed for free list. 

-r Report unused memory pages and disk blocks: 

freemem - average pages available to user processes; 
freeswap - disk blocks available for process swapping. 

-D Report Remote File Sharing activity: 

When used in combination with -u, -b, or -c, it causes sar to 
produce the remote file sharing version of the corresponding 
report. -Du is assumed when only -D is specified. 

-S Report server and request queue status: 

Average number of Remote File Sharing servers on the system 
(serv/lo-hi), % of time receive descriptors are on the request 
queue (request %busy), average number of receive descriptors 
waiting for service when queue is occupied (request avg Igth), 
% of time there are idle servers (server %avail), average number 
of idle servers when idle ones exist (server avg avail). 

-A Report all data. Equivalent to -udqbwcayvmprSDC. 

-C Report Remote File Sharing buffer caching overhead: 

snd-inv/s - number of invalidation messages per second sent by 
your machine as a server. 

snd-msg/s - total outgoing RFS messages sent per second, 
rcv-inv/s - number of invalidation messages received from the 
remote server. 

rcv-msg/s - total number of incoming RFS messages received 
per second. 

dis-bread/s - number of buffer reads that would be eligible for 
caching if caching were not turned off. (Indicates the penalty of 
running uncached.) 

blk-inv/s - number of buffers removed from the client cache. 



Examples 

To see today's CPU activity so far: 
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sar 

To watch CPU activity evolve for 10 minutes and save data: 

sar -o temp 60 10 
To later review disk and tape activity from that period: 

sar -d -f temp 



Data Gathering 

The operating system contains several counters that are incremented 
as various system actions occur. These include counters for CPU utili- 
zation, buffer usage, disk and tape I/O activity, TTY device activity, 
switching and system-call activity, file-access, queue activity, inter- 
process communications, paging, and Remote File Sharing. 

sadc and shell procedures, sal and sa2 , are used to sample, save, and 
process this data. 

sadc, the data collector, samples system data n times, with an interval 
of t seconds between samples, and writes in binary format to ofile or to 
standard output. The sampling interval t should be greater than 5 
seconds; otherwise, the activity of sadc itself may affect the sample. 
If t and n are omitted, a special record is written. This facility is used 
at system boot time, when booting to a multiuser state, to mark the 
time at which the counters restart from zero. For example, the 
/etc/init.d/perf file writes the restart mark to the daily data by the 
command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sadate +%d" 

The shell script sal , a variant of sadc, is used to collect and store data 
in binary file /usr/adm/sa/sa^W where dd is the current day. The argu- 
ments t and n cause records to be written n times at an interval of t 
seconds, or once if omitted. The entries in 
/usr/spool/cron/crontabs/sys [see cro«(C)]: 

0 * * * 0-6 /usr/lib/sa/sal 

20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours and 
hourly otherwise. 

The shell script sa2, a variant of sar writes a daily report in file 
/usr/adm/sa/sar^. The /usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 
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will report important activities hourly during the working day. 
The structure of the binary daily data file is: 



struct sa { 

struct sysinfo si; 
struct minfo mi; 
struct dinfo di; 
struct rcinfo rc; 
struct bpbinfo bi; 
int hpbjutilize 



/* see /usr/include/sys/sysinfo.h */ 

/* defined in sys/sysinfo.h */ 

/♦ FFS info defined in. sys/sysinfo.h */ 

/♦ Client cache info defined in sys/sysinfo.h */ 

/♦ Co-processor info defined in sys/sysinfo.h */ 

/♦ Co-processor utilize flag ♦/ 



int tninserve, maxserve; 



/♦ FFS server low and high water marks ♦/ 



int 
int 
int 
int 
int 
int 
int 
int 
int 
int 
Icxig 
long 
long 
time 
long 
int 
int 

♦define lojps 
♦define I0_BCNT 
♦define iqjCT 
♦define iq_RESP 

); 



szinode; /* current size of inode table */ 

szfile; /* current size of file table */ 

szproc; /♦ current size of proc table ♦/ 

szlckf ; /* current size of file record header table ♦/ 

szlckr; /* current size of file record lock table */ 

mszinode; /* size of inode table ♦/ 

mszfile; /♦ size of file table ♦/ 

mszproc; /* size of proc table */ 

mszlckf ; /♦ maxinum size of file record header table ♦/ 

mszlckr; /♦ maxinum size of file record lock table */ 

inodeovf ; /* cuirulative overflows of inode table ♦/ 

fileovf ; /* cunulative overflows of file table */ 

prooovf ; /* cunulative overflows of proc table ♦/ 

_t ts; /* time stanp, seconds */ 



devio[HEVS] [4]; 



/♦ device unit information ♦/ 



cachehits;/* nvnber of name cache hits */ 
cachemisses; /* ntnber of name cache misses */ 

0 /* cunulative l/o requests */ 

1 /* cunulative blocks transferred ♦/ 

2 /* cunulative drive busy time in ticks 

3 /* cunulative l/o reap time in ticks */ 



*/ 



Flies 



/usr/adm/sa/sad<i daily data file 

/usr/adm/sa/sardy daily report file 

/tmp/sa..adrfl address file 

Notes 



Output files created with this version of sar cannot be interpreted by 
earlier versions. However, this version interprets older output files 
correctly. 

See Also 



cron(C), sag(ADM), timex(ADM) 
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Standards Conformance 

sal, sa2y sadc and sar are conformant with: 
AT&TSVID Issue 2, Select Code 307-127. 
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schedule 



database for automated system backups 
Description 



The schedule database is used in conjunction v/iih fsphoto (ADM) to 
partially automate system-wide backups. For each filesystem to be 
backed-up, a cyclical schedule of xbackup (ADM) or cpio(C) levels is 
specified, (fsphoto uses cpio(C) or xbackup(ADM), for XENIX or for 
UNIX filesystems, respectively.) 

This cyclical schedule (or cycle ) is a list of dump levels to perform 
(including no dump at all) and a pointer to the last-used element of 
that list. The pointer is advanced to the next element of the list on a 
regular basis (each time fsphoto is run, usually once per day), starting 
over at the beginning each time it falls off the end. It is advanced, 
however, only on success - the desired dump must have been success- 
ful. 

Each entry in the file is on a separate line. Blank and comment lines 
(beginning with "#") may be placed anywhere. Several keywords are 
recognized: 

site sitename 

Sitename is passed to fsave as a description to place on each tape 
label. Usually, sitename is the name of the company or a building 
number. 

media drive k sizes... [format] 

Device drive is a floppy capable of handling volumes with any of 
the listed sizes (in kilobytes). If specified, /orwaf is the UNIX com- 
mand used to format the described floppies. 

media drive d density sizes... [format] 

Device drive is a density BPI magtape capable of handling tapes of 
any of the indicated sizes (in feet). Like floppies, format is the 
optional UNIX command used to format the described tape. 

[0-9] size savetime importance marker 

Description of each dump level, as described in fsave (ADM). The 
defaults are: 



Level 


Size 


Savetiite 


Inportance 


Marker 


0 




"1 year" 


critical 


none 


1 




"3 months" 


necessary 


none 


2. ..7 




"1 nonth" 


irtportant 


none 


8 




"2 weeks" 


liseful 


none 


9 






precautionary 


none 
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All four fields must be specified. A size of - means to use the first size 
listed in the appropriate media sizes list. 

Keywords should be placed before any filesystem dump schedules. A 
filesystem dump schedule is of the form: 

/dev/rfilesys cycle 

The filesystem resident on device /dev/filesys is to be backed-up 
according to cycle , which is a space-separated list of dump levels 
(the digits 0 to 9, passed to dump), or the letter x, meaning no 
dump should occur. 

A dump cycle must have at least one member, but it may be of any 
length. Different filesystems may have cycles of different lengths. 

Here is a sample schedule file: 

# SYSTEM BACKUP SCHEDULE 
site rr^machine 

# Media Entries 

# 96 tpi 1.2 MB floppy 0 

# media /dev/rfd096dsl5 k 1200 format /dev/rfd096dsl5 

# 96 tpi 1.2 MB flc^jpy 1 

# itedia /dev/rfdl96dsl5 k 1200 format /dev/rfdl96dsl5 

# Cartridge tape 0 

# media /dev/rctO d 20000 300 450 600 tape erase 

# 9-track tape drive 

# media /dev/rmtO d 1600 2400 1200 600 

# Backup Descriptor Table 

# Backi;?) Vol. Save for Vitality Label 

# level size how long (irtportance) marker 

0 - "1 year" critical "a red sticker" 

1 - "4 months" necessary "a yellow sticker" 

8 - "3 weeks" useful "a blue sticker" 

9 - "1 wsek" precautionary none 

# Schedule T^le 

# 12345 6789012345 67890 

# Filesystem MTWTF MTWTF MTWTF MTWTF ^fethod 
/dev/rroot 0x9x9 8x9x9 1x9x9 8x9x9 cpio 
/dev/ru 90999 98999 91999 98999 cpio 



In the example above, filesystem /dev/rroot is dumped using a level 0 
dump the first time fsphoto is run (on a Monday), and if that dump is 
successful, the next (second) time it runs (Tuesday), no dump is per- 
formed. If doing nothing is successful, the third time run (Wednesday) 
a level 9 dump occurs. If that dump succeeds, no dump occurs the 
fourth time (Thursday), but the fifth time fsphoto is run (Friday), a 
level 9 dump is made. 
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Each time a successful dump at the specified level happens, the 
pointer advances so that the next run of fsphoto (on the next weekday) 
will do the next dump scheduled for that filesystem. If however, a 
dump fails (or is interrupted or postponed by the operator) the pointer 
is not advanced; hence, the next time fsphoto is attempted, the same 
level dump will again be tried so the sequence will not be broken (but 
the timing may be off). 

Continuing the example, the nineteenth time fsphoto runs, a level 9 
dump of /dev/rroot is done, no dump is performed the next (twentieth) 
time, but the twenty- first time (Monday of every fifth week) the cycle 
starts over again at the beginning with a level 0 dump. 

The larger and more rapidly changing filesystems /dev/ru is dumped 
more frequently (each time fsphoto is run - once a day - instead of 
every other time), and the levels used are staggered to prevent having 
to perform two full-scale dumps (like levels 0 or 1) of the large 
filesystems on the same day. The backup cycle period is also shorter, 
two weeks instead of four. 

The Method field defines the backup utility to be used, cpio works for 
both XENIX and UNIX filesystems, but xbackup works only on XENIX 
filesystems. 

See Also 



fsphoto(ADM), fsave(ADM), xbackup(ADM) 

Notes 



Keywords and filesystem names must not be preceded by any spaces 
or tabs. 

It is not necessary to specify the name of the "raw" (/dev/r*) device 
for each filesystem, but the backups are faster if this is done. 

Value Added 



schedule is an extension of AT&T System V provided in Altos UNIX 
System V. 
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scsinfo 

display current SCSI device information 

Syntax 

scsinfo [ -q ] [ [ -t I [ -n I -p devname] I [ -s I -i indexU ] ] 

Description 

scsinfo displays information about all the current SCSI hard disks and 
tape drives, or one in specific. For each device, it displays the follow- 
ing: 

• device name 

• logical SCSI index (not including SCSI controller) 

• major and minor numbers (hard disks only) 

• slot number of the card it resides in 

• host adapter driver prefix 

• host adapter number (channel number) 

• SCSI ID 

• SCSI Logical Unit Number (LUN) 

Typing scsinfo with no options displays information for all SCSI hard 
disks currently loaded on the system. Type scsinfo -t to display infor- 
mation on all SCSI tape drives. 

You may also request information for specific devices only. Identify 
such devices with either their device name ( -p for tapes, -n for disks), 
or SCSI index number (-s for disks, -i for tapes). 

Options 

Options to scsinfo are: 

-q Enable quiet mode. Displays hard disk information (as with 
default use), but with no headers and no prompting for page breaks. 



March 19, 1991 



SCSINFO-1 



SCSINFO (ADM ) SCSINFO (ADM ) 

-t Display information for all tape drives currently installed. 
-ndevname 

Display information for the specified hard disk, as identified by its 
device name, devname, 

-p devname 

Display information for the specified tape drive, as identified by its 
device name, devname. 

-s indextt 

Display information for the specified hard disk, as identified by its 
logical SCSI index number, indexU. Logical index numbers for 
SCSI disks range from 0 to 51. 

-i indexit 

Display information for the specified tape drive, as identified by its 
logical SCSI index number, index#. Logical index numbers for 
SCSI tapes range from 0 to 7. 

Notes 



For more infomation on SCSI hard disk device numbering, see the 
table found in diwy (ADM). 

Value Added 



scsinfo is an extension to AT&T System V provided in Altos UNIX 
System V. 
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setclock 

sets the system real-time (time of day) clock 

Syntax 

setclock [ time ] 

Description 

The setclock file sets the battery-powered, real-time time of day clock 
to the given time. If time is not given, the current contents of the 
battery-powered clock are displayed. The time must be a combination 
of digits with the form: 

MMddhhmmyy 

where MM is the month, dd is the day, hh is the hour, mm is the 
minute, and yy is the last two digits of the year. If yy is not given, it is 
taken fi-om the current system time. For example, tiie command: 

082615035 

sets the time of day clock to 15:03 on August 26, 1985. 

Files 

/etc/setclock 

See Also 

clock(F) 

Notes 

Not all computers have battery-powered real-time time of day clocks. 
Refer to your computer's hardware reference manual. 

Value Added 

setclock is an extension of AT&T System V provided in Altos UNIX 
System V. 
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setmnt 

establishes /etc/mnttab table 

Syntax 

/etc/setmnt 

Description 

setmnt creates the /etc/mnttab table (see mnttab(F)\ which is needed 
for both the mount(ADM) and umount(ADM) commands, setmnt 
reads the standard input and creates a mnttab entry for each line. 
Input lines have the format: 

filesys node 

where filesys is the name of the file system's special file (e.g., "hdO") 
and node is the root name of that file system. Thus filesys and node 
become the first two strings in the mnttab (F) entry. 

Flies 

/etc/mnttab 

See Aiso 

mnttab(F) 

Notes 

If filesys or node are longer than 128 characters, errors can occur. 

setmnt silently enforces an upper limit on the maximum number of 
mnttab entries. 

setmnt is normally invoked by the /etc/rc2 scripts when the system 
boots up. 
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settime 



changes the access and modification dates of files 
Syntax 



settime mmddhhmm [ yy ] [ -f fname ] name ... 

Description 



Sets the access and modification dates for one or more files. The 
dates are set to the specified date, or to the access and modification 
dates of the file specified via -f. Exactly one of these methods must 
be used to specify the new date(s). The first mm is the month number; 
dd is the day number in the month; hh is the hour number (24 hour sys- 
tem); the second mm is the minute number; yy is the last two digits of 
the year and is optional. For example: 

settime 1008004583 ralph pete 

sets the access and modification dates of files ralph and pete to Oct 8, 
12:45 AM, 1983. Another example: 

settime -f ralph John 

This sets the access and modification dates of the file John to those of 
the file ralph. 

Notes 



Use of touch in place of settime is encouraged. 
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shutdown 



terminates all processing 
Syntax 



/etc/shutdown [ -y ] [ -g[hh:]mm ] [ -i[0156sS] ] [ -f 'mesg" ] [ -flFlLE ] 
[su] 

Description 



The primary function of shutdown is to terminate all currently running 
processes in an orderly and cautious manner, shutdown goes through 
the following steps: 

1. All users logged on the system are notified to log off the system 
by a broadcasted message. 

2. /etc/init is called to perform the the actual shutdown. 

Only the super-user can execute the shutdown command. 

The options are as follows: 

-y Runs the command silently. If this option is not 

specified, shutdown will prompt for confirmation to 
shut down the system. 

-g[hh:]mm Specifies the number of hours and minutes before 
shutdown (maximum: 72 hours). 60 seconds is the 
default. (To shut down the system immediately 
without a grace period, use /etc/haltsys or 
/etc/reboot). 

-i[0156sS] Specifies the init level to bring the system to (see 
init(M)). By default, the system is brought to level 0. 

-fmesg mesg is a message enclosed in double quotes ("") to 
be sent to all terminals warning of the imminent 
shutdown during the grace period. 

-f FILE Similar to the -fmesg option, but FILE is the path- 
name for a file containing the message. 
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The optional su argument lets the user go single-user, without com- 
pletely shutting down the system (this option is identical to -11 and is 
present for backwards compatibility with XENIX). Broadcast mes- 
sages, whether default or defined, are displayed at regular intervals 
during the grace period. The closer the shutdown time, the more fre- 
quent the message: 



Time left until shutdown Frequency of message 
Greater than 1 hour Every hour 
Greater than 15 minutes Every 15 minutes 
Less than 15 minutes Every minute 

In general, if no options are specified, shutdown behaves as follows: 

1 . Prompt for confirmation 

2. 60-second grace period 

3. Bring the system to init level 0 

4. Broadcast default message prior to shutdown. 

See Also 



wall(ADM), boot(HW) 

Diagnostics 



The most common error diagnostic that will occur is device busy. 
This diagnostic appears when a particular file system could not be 
unmounted. See umount (ADM). 

Notes 



Once shutdown has been invoked, it must be allowed to run to comple- 
tion and must not be interrupted by pressing BREAK or DEL. 

shutdown does not work when executed from within a shell layer. 

shutdown locks the hard disk heads. 

shutdown was developed at the University of California, Berkeley, and 
is used with permission. 
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strace 



prints STREAMS trace messages 
Syntax 



strace [ mid sid level ] ... 

Description 



strace without arguments writes all STREAMS event trace messages 
from all drivers and modules to its standard output. These messages 
are obtained from the STREAMS log driver [log(M)]. If arguments are 
provided they must be in triplets of the form mid, sid, level, where mid 
is a STREAMS module id number, sid is a sub-id number, and level is a 
tracing priority level. Each triplet indicates that tracing messages are 
to be received from the given module/driver, sub-id (usually indicat- 
ing minor device), and priority level equal to or less than the given 
level. The token all may be used for any member to indicate no re- 
striction for that attribute. 

The format of each trace message output is: 

<seq> <time> <ticks> <level> <flags> <mid> <sid> <text> 

<seq> trace sequence number 

<time> time of message in hh:mm:ss 

<ticks> time of message in machine ticks since boot 

<level> tracing priority level 

<flags> E : message is also in the error log 
F : indicates a fatal error 
N : mail was sent to the system administrator 

<mid> module id number of source 

<sid> sub-id number of source 

<text> formatted text of the trace message 

Once initiated, strace will continue to execute until terminated by the 
user. 
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Output all trace messages from the module or driver whose module id 
is 41: 

strace 41 all all 

Output those trace messages from driver/module id 41 with sub-ids 0, 
l,or2: 

strace 41 0 1 41 1 1 41 2 0 

Messages from sub-ids 0 and 1 must have a tracing level less than or 
equal to 1 . Those from sub-id 2 must have a tracing level of 0. 

See Also 



log(M), STREAMS Programmer's Guide 

Diagnostics 



Due to performance considerations, only one strace process is permit- 
ted to open the STREAMS log driver at a time. The log driver has a 
list of the triplets specified in the command invocation, and compares 
each potential trace message against this list to decide if it should be 
formatted and sent up to the strace process. Hence, long lists of tri- 
plets will have a greater impact on overall STREAMS performance. 
Running strace will have the most impact on the timing of the 
modules and drivers generating the trace messages that are sent to the 
strace process. If trace messages are generated faster than the strace 
process can handle them, then some of the messages will be lost. This 
last case can be determined by examining the sequence numbers on 
the trace messages output. 
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strclean 

STREAMS error logger cleanup program 

Syntax 

strclean ( -d logdir ] [-a age ] 

Description 

strclean is used to clean up the STREAMS error logger directory on a 
regular basis (for example, by using cron(C)). By default, all files 
with names matching error.* in /usr/adm/streams that have not been 
modified in the last 3 days are removed. A directory other than 
/usr/adm/streams can be specified using the -d option. The max- 
imum age in days for a log file can be changed using the -a option. 

Example 

strclean -d /usr/adm/streams -a 3 
has the same result as running strclean with no arguments. 

Notes 

strclean is typically run from cron(C) on a daily or weekly basis. 

Files 

/usr/adm/streams/error. * 

See Also 

cron(C), strerr(ADM), STREAMS Programmer's Guide 
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strerr 



STREAMS error logger daemon 
Syntax 



strerr 

Description 



strerr receives error log messages from the STREAMS log driver 
[log(M)] and appends them to a log file. The error log files produced 
reside in the directory /usr/adm/streams, and are named error.mm- 
dd, where mm is the month and dd is the day of the messages con- 
tained in each log file. 

The format of an error log message is: 

<seq> <time> <ticks> <flags> <mid> <sid> <text> 

<seq> error sequence number 

<time> time of message in hh:mm:ss 

<ticks> time of message in machine ticks since boot priority 
level 

<flags> T : the message was also sent to a tracing process 
F : indicates a fatal error 
N : send mail to the system administrator 

<mid> module id number of source 

<sid> sub-id number of source 

<text> formatted text of the error message 

Messages that appear in the error log are intended to report excep- 
tional conditions that require the attention of the system administrator. 
Those messages which indicate the total failure of a STREAMS driver 
or module should have the F flag set. Those messages requiring the 
immediate attention of the administrator will have the N flag set, 
which causes the error logger to send the message to the system 
administrator via mailiC). The priority level usually has no meaning 
in the error log but will have meaning if the message is also sent to a 
tracer process. 
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Once initiated, strerr will continue to execute until terminated by the 
user. Commonly, strerr would be executed asynchronously. 

Notes 



Only one strerr process at a time is permitted to open the STREAMS 
log driver. 

If a module or driver is generating a large number of error messages, 
running the error logger will cause a degradation in STREAMS perfor- 
mance. If a large burst of messages are generated in a short time, the 
log driver may not be able to deliver some of the messages. This 
situation is indicated by gaps in the sequence numbering of the mes- 
sages in the log files. 

Files 



/usr/adm/streams/error.wm-cW 

See Also 



log(M), STREAMS Programmer's Guide 
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strmcfg 

STREAMS configuration utility for networking products 
Syntax 



strmcfg is a STREAMS configuration utility that calculates optimum 
values for selected STREAMS parameters based on the various condi- 
tions under which your networking products are running. You may 
also use strmcfg to calculate STREAMS parameters for a selected 
product or group of products. 

When invoked, strmcfg reads each data file (one file per product) in 
the default directory /usr/altos/tuning/streams/data and passes the 
configuration requests (or questions) contained in each file to the user. 
strm^g uses these responses (along with other data defined in the file) 
to calculate optimal STREAMS parameter values. After all questions 
in every file are asked, strmcfg writes the resulting parameter values 
to an output file and then exits. The default output file is 
/usr/altos/tuning/streams/results. The parameter values in this file 
can be implemented in the kernel with the idtune{ADM) command, or 
you can use the strmtune{ADM) utility to configure these values in 
your kernel. In an adjoining directory, ./config, there are data files for 
each product. These data files contain information about the parame- 
ter values set by each product. The default direcotry is 
/usr/altos/tuning/streams/config. If you use strmtune^PiDM) to con- 
figure the kernel using the results file, product files with the extension 
.cfg are also saved in this directory. 

The results file is overwritten each time strmcfg is invoked, so if you 
need the existing results file, move it before invoking strmcfg (or use 
the -f option, described below). The product files are also rewritten. 

Here is a list of the configurable STREAMS parameters: 



/altos/bin/strmcfg [-h] [-d directoryname] [-f filename] 



Description 



NBLK4 

NBLK16 

NBLK64 

NBLK128 

NBLK256 



NBLK1024 NNFSRNODE 



NBLK2048 NQUEUES 

NBLK4096 NS5IN0DE 

NFILE NUMTIM 

NINODE NUMTRW 
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NSTREAM 



Print a brief help message about strmcfg . 



-d directoryname 



-f filename 



Search the directory directoryname for the data 
files. If not specified, the default directory 
/usr/altos/tuning/streams/data is searched. 

Write the resulting STREAM parameter values in 
the file filename . If not specified, the default out- 
put file /usr/altos/tuning/streams/results is used. 
The product- specific configuration files will be 
stored in an adjoining directory, ./config. 



Print information about your current configura- 
tion. 



Data File Format 



This section describes how to modify a data file, or create a new one. 
The data file contains the following special strings: 



PRODUCT: 

QUESTION: 

ANSWER: 

PARAMETERS: 

n: 

# 



Every line in the data file must begin with one of these strings. There 
cannot be any white spaces before the special strings/characters; they 
must occur at the start of each line in column one. Also, data lines 
cannot have any carriage return or new-line characters in them, except 
at the end of the line. 

Each string and its use are described below: 



PRODUCT: The product name should follow this string, and 
should be terminated with a colon (:). 

QUESTION: This string identifies a configuration query, which 
must be terminated with a colon (:). 

ANSWER: All legal answers to the preceding question follow 
the ANSWER: string. TTie answers are separated 
by a comma (,), and the entire line must be 
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terminated by a conima too. 

Each answer is used later in the file to identify the 
exact parameter values it changes. Seen: below. 

PARAMETERS: The line prefaced by the PARAMETRS: string 
should contain all the STREAMS parameters that 
are affected by the preceding question. As with the 
ANSWERS: string, the parameters must be 
separated by a comma (,), and the line terminated 
with one too. 

n: For every valid answer n defined in the ANSWER: 

string, there should be a line starting with n: that 
specifies how the parameter values are changed if 
this answer is selected. The n: line contains pairs 
of values, one pair for each parameter listed in the 
PARAMETRS: string, in the order these parameters 
are listed. The first number in the pair defines the 
minimum value of the corresponding parameter 
when the answer n is selected. The second number 
defines the "step" value by which the current 
parameter value is incremented (if already at or 
above the minimum value). 

Each number in this string is separated by a comma 
(,), and the entire line is terminated with a comma. 

# Any line starting with the pound character is 
ignored. Use this character for comment lines in 
tiie data file. 

An example data file is listed below. 

# streams timing script for TCP/IP 
# 

# the name of the product for which this file is used 
# 

PRODUCT: Altos TCP/IP: 

QUESTION: Indicate maximum circuits : 

# 

# the only valid answers are 8, 16, 32, and 64 
# 

ANSWER:8, 16,32, 64, 
# 

# the parameters NBLK16, NBLK64, NBLK128, NBLK1024 

# are modified depending upon the answer supplied 
# 

PARRMETERS :NBLK16 , NBLK64 , NBLK128 , ^IBLK1024 , 
# 

# if '8' is selected, the various parameters are changed by the 

# (minimum, step) pairs (50,10), (150,11), etc. 

# this means that if the NBLK16 value is not at least '50' it will be 
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# set to that, otherwise the current value will be incremented by 
# 

8 : 50, 10, 150, 11, 150, 10, 290, 25, 
16 : 60, 10, 120, 30, 180, 10, 290, 25, 
32:80,10,160,50,240,10,290,25, 
64:100,10,200,70,300,10,290,25, 
# 

QUESTION: Question Two ? : 
ANSWER:B,16,32,64, 

PARAMETERS : rmLKl 6 , KIBLK6 4 , NBLKl 2 8 , ^IBLK1 0 2 4 , 
8 : 50, 10, 150, 11, 150, 10, 290, 25, 
16:60,10,120,30,180,10,290,25, 
32:80,10,160,50,240,10,290,25, 
64:100,10,200,70,300,10,290,25, 

Files 



/usr/altos/tuning/streams/data 

/usr/altos/tuning/streams/results 

/usr/altos/tuning/streams/config 

See Also 



idtune(ADM) 

Value Added 



strmcfg is an extension to AT&T System V provided in Altos UNIX 
System V. 
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strmtune 



STREAMS configuration interface for networking prod- 
ucts 

Syntax 



/usr/altos/bin/strmtune 

Description 



This utility helps you configure your kernel for specific communica- 
tion products. It lets you run the strmcfg(ADM) utility, tune your ker- 
nel STREAM parameters in accordance with output of strmcfg, 
decrease the STREAMS parameters you have configured, and finally 
view your current STREAMS parameter configuration. 

Options 



1. Run strmcfg with default options 

This option runs the strmcfg utility with the default options, i.e. the 
data files will be read from /usr/altos/tuning/streams/data, the 
results file will be /usr/altos/tuning/streamsn'esults, and finally 
the product- specific files will be stored in the directory 
/usr/altos/tuning/streams/config. 

2. Tune kernel with new parameters 

This option will configure your kernel in accordance with the 
results produced by option 1. After all the parameters have been 
adjusted, you will be asked if you want to relink the kernel. The 
new configuration will not take effect until you have rebuilt the 
kernel and rebooted the system. 

3. Remove added parameters from kernel 

This option will decrease the kernel parameters you have added 
using option 2, You will be asked for each product configured, 
whether or not you want to remove the paramters. It will then 
adjust your kernel parameters accordingly. After all the parame- 
ters have been adjusted, you will be asked if you want to relink the 
kernel. The new configuration will not be in effect until you have 
rebuilt the kernel and rebooted the system. 
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4. Display Streams Parameters 

This option displays your current streams configuration. You 
should use this option frequently to examine how your changes are 
affecting your kernel parameters. 

Output from Display option 



This section will explain how you can interpret the information dis- 
played by option 4. In all examples only a part of the STREAMS 
parameters will be shown. Option 4 will always show you the configu- 
ration of all of the STREAMS paramters. 

When you first invoke strmtune, the kernel parameters will not be spe- 
cifically tuned for any communications products. The output of 
option 4 will look something like this: 



Current STREAMS Configuration: 



Kernel Current Cotnunications Parameter Proposed new Pressed new 

STREAM Value in Product (s) Increase Increase Value for 

Paraireter: Kernel: Configured: by product: by product: parameter: 



NSTREAM 192 (none) 

NBLK4 256 (none) 

NBLK4096 0 (none) 

NFILE 512 (none) 



This output shows you the current value of the STREAMS parameters 
(column 2), It also shows you that these values have not been affected 
by configuring any communications packages (column 3). 

If you then run option 1 from the menu, and configure for Altos 
TCP/IP and Altos NFS. 



Current STREAMS Configuration: 



Kernel Current Ccaimunications Parameter Proposed new Pressed new 
STREAM Value in Product (s) Increase Increase Value for 

Parameter: Kernel: Configured: by product: by product: parameter: 



NSTREAM 192 Altos TCP/IP - 10 234 

Altos NFS - 32 

NBLK4 256 Altos TCP/IP - 60 316 

NBLK4096 0 Altos TCP/IP - 2 2 
NFILE 512 (none) 



This output shows you the same current value of the STREAMS 
parameters (column 2) as before. Column 3 now lists the packages that 
we have configured, and which affects this particular parameter. For 
example, NSTREAM is affected by Altos TCP/IP and Altos NFS, 
while NBLK4 is only affected by Altos TCP/IP. (ilolumn 5 shows you 
how much a particular package will increase a parameter, and column 
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6 shows you what the parameter wili be set to in the kernel if you 
choose to tune your kernel using this configuration (using option 2 
from the main menu). In this case, NSTREAM will increase from 192 
to 234, because TCP/IP will add 10 and NFS will add 32. 

After you have examined and approved your changes you can go back 
to the main meny and choose option 2. If you display the stream con- 
figuration afterwards, it will look something like this: 



Current STREfiMS Configuration: 



Kernel Current Ccrmunications 

STREAM value in Product (s) 
Parameter: Kernel: Configured: 



Paraneter Pressed new Prcposed new 
Increase Increase Value for 
by product: by product: paraneter: 



NSTREAM 234 Altos TCP/IP 10 

Altos NFS 32 

^BLK4 316 Altos TCP/IP 60 

^BLK4096 2 Altos TCP/IP 2 
NFILE 512 (none) 



This shows you that the value of the STREAMS parameters in the ker- 
nel has changed, it also shows you to which communications packages 
you can contribute this change. If you choose to remove the added 
parameters (using option 3 from the menu) for TCP/IP, e.g. the 
NSTREAM parameter would decrease by 10 to 224. 



Current STREAMS Configuration: 



Kernel Current 
STREAM Value in 
Parameter: Kernel: 



Ccnmunications Parameter Prcposed new Proposed new 
Product (s) Increase Increase Value for 

Configured: by product: by product: parameter: 



NSTREAM 



NBLK4 



NBLK4096 
NFILE 



234 



316 



2 

512 



Altos TCP/IP 
Altos DOS Server 
Altos NFS 
Altos TCP/IP 
Altos DOS Server 
Altos TCP/IP 
(none) 



10 



32 
60 



10 
32 

60 
30 
4 



266 

346 
4 



This is an example of how the output will look if you run the strmcfg 
utility (option 1) after you have already configured the kernel once. In 
this example configurations for DOS Server is added, and TCP/IP has 
been changed from 8 to 16 file transfer users. Column 2 shows you 
what the current kernel values are. Column 4 shows you what the 
current kernel values are per product. In column 5 you can see the 
new values for the products you have added or reconfigured. A dash 
in this column means that you have choosen not to change this 
product. A new product will have its configurations added to the ker- 
nel values. An updated product will have the new configuration 
replacing the old values. 
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/usr/altos/tuning/streams/data 
/usr/altos/tuning/ streams/results 
/usr/altos/tuning/streams/config 

See Also 



strmcfg(ADM) 

Value Added 



strmtune is an extension to AT&T System V provided in Altos UNIX 
System V. 
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submit 



MMDF mail enqueuer 
Syntax 



submit [-L...*V...*Wbcdf...*g...*hi...*jk...*lmnqrstuvwxyz] 

Description 



All mail is entered into the MMDF mail transport environment 
through the submit program. This document is intended to provide the 
specific information needed to control submit. While it can be called 
directly from a user's terminal, access to submit is most conveniently 
done through a program such as mail(C). It also will be useful to read 
replies(M), which describes reply values. 



Basic Modes 

submit permits considerable flexibility with respect to batching multi- 
ple submissions, response and error handling, and address source spe- 
cification. 



Multiple Submissions 

1. Terminate after one submission, such as is done by the mail com- 
mand, or 

2. Permit multiple message submissions, as is done by the SMTP 
channel and the MMDF telephone slave. 

The first mode is specified by passing any initialization information in 
the submit invocation line (i.e., the exec lS) call). In the second mode, 
the initialization information is given as the first input line, for each 
submission. The format of this information is the same for both 
modes. 



Response & Error Handling 

1. Accept input until error or end of message, but terminate on any 
error, or 
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2. Notify result for each segment and continue. 

Response mode #1 is mandatory with Multiple mode #1. Response 
mode #2 is called protocol mode. During it, each address produces a 
status reply and the message text produces a reply. The domain of the 
term segment depends on the error. Simple addressing errors cause 
rejection only of tfie erroneous address. Other errors may cause rejec- 
tion of the entire message, but permit submission of following mes- 
sages. 



Addresses 

1. Extracted from components of the message text, 

2. Explicit list given, ahead of message text, or 

3. Both of the above (extracted and explicit addresses) 

The first mode is common when mode #1 (non-protocol) is also in 
force for the Interaction and the Verification option. The second mode 
is commonly in force when the second modes apply for the other 
options (protocol mode). 



Initialization 

A message's initialization information is specified through a single 
string, passed either in the process-invocation argument list or in 5ie 
first line of submit input. Hence, the string may be terminated either 
by a null or newline. Spaces and tabs in the line are ignored, unless 
part of a literal. Specification is only required for non-defaults. 



Option Value Literal 

1. Relay source a. none (default) 
for the "Via" or b. source channel i...* 

' 'Received' ' field c. source host h...* 

2. From/Sender a. reject on error (default) 
authentication b. trust t 

c. no trust (disclaim) u 

3. Source-Info Field a. not included (default) 

b. disclaim author u 

c. user text f...* 

4. Address list source 

a. explicit list (default) 

b. extract from x...* 
components 

c. both (extract and g...* 
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explicit) 

5. Address verification 

a. abort on invalid (default) 

b. report on each v 
address 

6. Delivery destination 

a. mailbox m (default) 

b. user's tty y 

c. mailbox and tty b 

7. Delivery attempt a. leave for daemon (default) 
(combinable) b. deliver local now 1 

c. deliver netmail now n 

8. Observation of a. none (default) 
immediate b. user will watch w 
attempts 

9. Return address a. send to submitter r 

b. send to ' ' Sender: ' ' s 

c. do not return q 

d. as specified (next line) 

10. Returned mail a. entire original (default) 
contents b. citation only c 

11. Warnings a. send warnings (default) 

b. do not send warnings z 

12. Delay channel a. enable delay channel (default) 
usage b. don't use delay d 

13. Delay channel a. not delay channel (default) 
indicator b. delay channel j 

14. Nameserver a. short timeouts (default) 
timeouts b, as specified k...* 

15. Submission a. not shown (default) 
tracing b. watch submission W 

16. Logging file a. as per msglog (default) 

b. as specified L..,* 

17. Logging level a. as per msglog (default) 

b. as specified V..,* 
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Comments 
General 

Literals shown as characters, followed by an ellipsis, followed by 
an asterisk (e.g. x...*), represent a string. The first character 
specifies the nature of the setting. The value for the setting is 
placed between that character and the asterisk. The value may be 
any string not containing an asterisk, null, or newline. The values 
for settings x and g are comma-separated lists of strings. These 
strings may not contain asterisks, nulls, newlines, or commas. 

Specific 

1. Relaying 

This is used when the calling program is interfacing with another 
distribution system, effecting relaying. The literal after the i 
specifies the channel the message is coming from. The h may be 
used, in conjunction with i, to specify the source host. The literal 
is the name of the host. 

2. Authentication 

Normally, the message must correctly identify its sender. Anyone 
may send "anonymous" (unsigned) mail, but they must use the u 
setting which bypasses authentication. However, it also causes 
MMDF to include, in the Source-Info: component, a statement 
noting the absence of authentication. Only root or relays may use 
the t setting, which bypasses authentication and does not add a dis- 
claimer. Others requesting it get u treatment. 

3. Source-Info 

In addition to the action explained above, Source-Info: can 
directly receive text, from the user, through the f setting. The 
value string is replicated on a separate line in the field. 

4. Address lists 

An explicit list has one address per line. When x or g are specified, 
they list the names of message components, such as "To:" and 
"CC:", which are to be searched for addresses. 

5. Verification 

Normally, any illegal address will cause the entire message to be 
rejected. In v (verify) mode, the acceptability of each message is 
reported and encountering an illegal address does not abort sub- 
mission. 

6. Delivery type 

Mail may be delivered to a recipient' s mailbox (file), online termi- 
nal (if the recipient is logged in), or a combination of the two. 
There is no default. For each message, its delivery mode must be 
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specified. 

7. Attempt 

An immediate attempt causes a special deliver process to be 
forked and it will attempt to process the indicated mail immedi- 
ately. (The n setting does not allow more granularity, for histori- 
cal reasons.) Otherwise, the system's background daemon will get 
to it eventually. The daemon also handles mail that initially could 
not be delivered/relayed. A channel's descriptor structure (in 
chan.c or the runtime tailor file) specifies a channel as being 
Active, Passive, or Background. Only the first is processed by any 
request for immediate delivery. The second indicates a Post Office 
Box-style channel. The third limits the channel to processing by 
the background deliver daemon, which may be necessary for re- 
stricting access to special channels, such as dial-out telephones. 

8. Observation 

If an immediate attempt is requested, the user may elect to watch 
its progress. Deliver and its children will report assorted aspects 
of their activity. If a quiet attempt is requested, submit returns as 
soon as submission is completed. That is, a quiet attempt is per- 
formed detached. 

9. Return address 

If the invoker of submit is not to receive return mail (e.g., 
notification of delivery failure) then the next input line (the first, if 
settings are specified in the exec(S) call), contains an address that 
should receive the notification. It is not validated. If either the r 
or the s switch is given, submit will not read a line for the return 
address. If no return mail should be sent, the return address line 
should be empty (i.e., consist of a newline, only.) If the q switch is 
given, a return address is read from the next line of input but the 
local system will not retum mail if delivery problems are encoun- 
tered. The retum address given may be used by other systems (if 
there are mail relays between the local system and the recipient). 

10. Retum contents 

Normally, a copy of the entire message is sent with a delivery- 
failure notice. Using the c switch causes a citation, comprising the 
message header and first three lines of non-blank lines of the body, 
to be sent. If more than 12 addresses are specified, for a message, 
citation-only is automatically set. In addition, no waming message 
will be sent for addresses which take a long time to process (a site 
dependent value); the final failure notice will always be sent, if 
there are addresses that are never fully processed. 

11. Wamings 

Normally MMDF will send a non-delivery waming if a message 
has been undelivered after a small period (typically 12 to 72 hours, 
depending on the site). Deliver attempts continue until a timeout 
period is reached. This is typically after 3 to 10 days, depending 
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on the site. 

12. Disable delay channel 

The delay channel is used to process mail submissions that could 
not queued because necessary nameserver information was una- 
vailable and therefore an authoritative decision on the validity of 
the address was not possible. If the d option is specified, use of the 
delay channel is prohibited. If the nameserver fails, a error is 
returned, rather than a conditional OK. 

13. Delay channel indicator 

This option is intended only to be used by the delay channel itself 
to indicate to submit that tiie invoking process IS the delay chan- 
nel. This option implies the d option above. 

14. Nameserver timeouts 

By default, MMDF uses a short timeout algorithm. This is suitable 
for user interface programs which don't want to wait a long time 
for dead nameservers. The k option allows a different timeout to 
be set. The value given is the number of seconds to wait for the 
nameserver lookup to complete. 

15. Submission tracing 

The W option causes submit to print a detailed description of its 
activities on file descriptor 2. It will indicate, for each addressee, 
the channel and addresses queued. This can generate a great deal 
of output if a mailing list is encountered, so it should be used with 
caution. 

16. Logging file 

The L option allows the specification of an alternate logging file at 
runtime. The string following the L should be the name of the 
logfile to be used. It can be terminated by a * or the end of the 
arguments. This option is only available to the Superuser or 
MMDF. 

17. Logging level 

The V option allows the setting of the logging level at runtime. 
The string following the V should be one of the valid MMDF log- 
ging level strings such as FTR or BST. It can be terminated by a * 
or tiie end of the arguments. This option is only available to the 
Superuser or MMDF. 
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Input Stream 

The following augmented BNF characterizes submit' s input (file 
descriptor zero) format: 

stream: *(init-seq "Nn' msg-info null) [null] 

init-seq: *{ switches listed above } 

msg-info: [ret-addr] "Nn' 

[addr-seq M"Vi'] 

{ rfc822-format message } 

ret-addr: { rfc822-format (return) address } 

addr-seq: *{ rfc822-address } 



Address Format 

Addresses are expected to conform to the ARPANET mail standard 
known as RFC-822, available from the Network Information Center at 
SRI International, submit (and MMDF in general) also continues to 
support RFC-733 style mail for compatibility with earlier mail sys- 
tems. 

In addition to those in RFC-822, the following address delimiters are 
recognized within the local part of addresses (in order of precedence): 

@ 
% 
! 



The delimiter is interpreted as "hostluser" while the others are 
interpreted as "user?host". For example, the address 
"a.b!user%c(a)localhost" would be queued for *'a.b!user@c". The 
address "a.b!user@localhost' ' would be queued for "user@a.b". The 
address "user.a@localhost" would be queued for "user@a". Note 
that recognition of the delimiter is a site-selectable option. 

Also, addresses may be indirectly referenced, through a file specifica- 
tion of the form: 

"<filename" or ":include: filename" 

where the angle-bracket must be the first non-blank character of the 
specification (to distinguish it from the "<...>" usage, above). 

Addresses in the file may be separated by commas or newlines. 
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Example Interactions 



Phases involve Invocation (Invoke), data sent into submit via its file 
descriptor zero (To), data returned from submit via its file descriptor 
one (From), iteration back to the specified phase (Loop), and process 
exit value (Exit). 

1. Simple, single-message, as with the v6mail command: 



a. Invoke: Parameters, "-mlrxto,cc*", indicate that the 

message is to be sent to recipients' mailboxes, 
local mail should be sent immediately, retum 
mail goes to the submitter, and addresses are to 
be extracted from the "To:" and *'cc:" com- 
ponents. 



b. To: The entke message 

c. From: Error messages 

d. Exit: Process retum value, in wait(&val), taken from 

mmdf.h, indicating submission status. 



2. Standard, multi-message protocol: 

a. Invoke: No parameters 

b. To: Initialization information line. A typical user 

program might have "mlrv", indicating the mes- 
sage is to be sent to mailboxes, local mail sent 
immediately, retum mail goes to the sender, and 
each address verification is to be reported. A 
relay program might have 

"mlntviVGR.BRL.MIL*," witii "mlv" as 
above and the other settings indicating that mail 
for non-local channels is to be sent immediately, 
the author information is to be trusted, and the 
"Received: " component should cite the mail as 
being relayed via Internet host VGR.BRL.MIL. 



c. To: One address, terminated by a newline CXn'). 

d. From: Status character, from mmdf.h, plus human- 

oriented text plus newline. 

e. Loop: Back to (c). Terminate with address line having 

only an exclamation mark (!), with newline. 

f. To: Message text, in Internet RFC #822 format. 

Multi-line, terminated by null (\0'). 
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g. From: Status character, text, newline. 

h. Loop: Back to (b). Terminate with initialization line 

having only a null, without newline. 

Channels 



When MMDF is used in conjunction with the DARPA domain 
nameserver system, a "delay" channel should be configured to 
allow queuing of addresses that fail verification temporarily due to 
nameserver failures (unavailability). Two other special channels 
that can be configureid are the "badusers" and "badhosts" chan- 
nels. Mail to unlaiown users or unknown hosts will be queued to 
these channels if they are configured. The bad channels have no 
special code associated with them. The channel configuration 
should reference whatever table and program is necessary to reach 
a smarter host which can deliver or forward the mail. The channel 
should have the *'host=" parameter set to this host name. The 
channel names given above are reserved. 

Files 



Numerous. Generally under the MMDF login directory. 

See Also 



send(ADM), mmdf(S), deliver(ADM) 
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sulogin 
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access single-user mode 

Syntax 

sulogin 

Description 

sulogin is automatically invoked by init when the system is first 
started. It prompts the user to type the root password to enter system 
maintenance mode (single-user mode) or to type CTRL-D for normal 
startup (multi-user mode), sulogin should never be directly invoked 
by the user. 

Files 

/bin/sulogin 

See Also 

init(M) 

Value Added 

sulogin is an extension of AT&T System V provided in Altos UNIX 
System V. 
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swap 



swap administrative interface 
Syntax 



/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -I 

Description 



The swap command provides a method of adding, deleting, and moni- 
toring the system swap areas used by the memory manager. The fol- 
lowing options are recognized: 

-a Add the specified swap area, swapdev is the name of the block 
special device, e.g., /dev/dsk/asO. swaplow is the offset in 512- 
byte blocks into Sie device where the swap area should begin. 
swaplen is the length of the swap area in 512-byte blocks. ITiis 
option can only be used by the super-user. Swap areas are nor- 
mally added by the system start-up routine /etc/rc when going 
into multiuser mode. 

-d Delete the specified swap area, swapdev is the name of a block 
special device, e.g., /dev/dsk/asO. swaplow is the offset in 512- 
byte blocks into tfie device where the swap area should begin, 
lliis option can only be used by the super-user. 

-1 List the status of all the swap areas. The output has four 
columns: 

DEV 

The swapdev special file for the swap area if one can be 
found in the /dev/dsk or /dev directories, and its major/minor 
device number in decimal. 

LOW 

The swaplow value for the area in 512-byte blocks. 
LEN 

The swaplen value for the area in 512-byte blocks. 
FREE 

The number of free 512-byte blocks in the area. 
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Notes 

No check is done to see if a swap area being added overlaps with an 
existing swap area or file system. 
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sync 

updates the super-block 

Syntax 

sync 

Description 

sync executes the sync system primitive. If the system is to be 
stopped, sync must be called to ensure file system integrity. Note that 
shutdown\A\yM) automatically calls sync before shutting down the 
system. 

See Also 

sync(S) 

Standards Conformance 

sync is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sysadmsh 



menu driven system administration utility 
Syntax 



sysadmsh 

Description 



sysadmsh is an easy-to-use menu interface designed to provide novice 
users with the tools needed for day-to-day system administration of 
the UNIX system. 

WARNING: sysadmsh does not replace the documentation. It pro- 
vides an overview of available system administration features and a 
reminder of tasks which need to be performed regularly. An under- 
standing of the Installation Guide, the System Administrator's Guide, 
and the User's Guide is necessary to use sysadmsh. 

Usage 



sysadmsh menus can be invoked by logging in as the super-user (root) 
and entering: 

sysadmsh 

at the shell prompt. 

Once you are in sysadmsh, on-line instructions for its use may be 
obtained by selecting the <F1> key. 

Some sysadmsh options must be run from the system console device. 
Some options must be run while in single user (system maintenance) 
mode. Check the documentation manud page referenced by the menu 
selection for more information. 

Environment Variables 



sysadmsh uses the following environment variables: 

• SCOLIB is used to locate the tcap directory which contains vari- 
ous terminal-specific 0/A files. The location procedure is: 
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the directory .leap/ terminal type is searched for in the user's 
home directory, if this does not exist then, 

the directory $(SCOLIB) /tcap/ terminal type is searched for, 
if this does not exist then, 

the directory .tcap/generic is searched for in the user's home 
directory, if this does not exist then. 

The directory $(SCOLIB) /generic is searched for. 

If the SCOLIB variable is not explicitly set then it defaults to 
/usr/lib/sco 

• SYSADM is used to find the 0/A prompt file libstrs, plus the 
menu, form and help files. 

There are three environment variables which sysadmsh considers to 
locate the editor it calls. SA_EDITOR is tried first, if this is null then 
VISUAL is tried, then EDITOR. 

If none of the editor environment variables are set then, one of the fol- 
lowing editors is chosen: /usr/bin/lyrix, /bin/vi or /bin/ed (listed in 
decreasing preference). 

The following additional environment variables are used: 

SA_MAIL If not set, the default mailer is SCX) Portfolio email if 
installed, or regular UNIX mail(C) if not. 

SA_PRINT If not set, the default printer device is /dev/lp. 

See Also 



System Administrator's Guide 
User's Guide 
Installation Guide 

acctcom(ADM), accton(ADM), asktime(ADM), at(C), badtrk(ADM), 
checklist(F), chgrp(C), chmod(S), chown(C), configure(ADM) 
copy(C), cron(C), csh(C), custom(ADM), df(C), difF(C), dircmp(C), 
disable(C), diskcmp(C), diskcp(C), dmesg(ADM), dos(C), dtype(C), 
du(C), enable(C), fdisk(ADM), find(C), finger(C), fixperm(ADM), 
format(C), fsck(ADM), grpcheck(C), init(M), kill(C), login(M), lp(C), 
Ipadmin(ADM), Ipstat(C), mail(C), mkdev(ADM), more(C), 
mount(ADM), netutil(ADM), ps(C), quot(C), shutdown(ADM), 
systemid(F), tar(C), umount(ADM), uuinstall(ADM), vi(C), 
wall(ADM), who(C), write(C) 
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Notes 
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A knowledge of vj(C) is assumed for file edit selections, although the 
SCO Lynx® editor is used when available. 

Acknowledgements 



This utility takes its design from the SCO Lyrix Word Processing Sys- 
tem. 

Value Added 



sysadmsh is an extension of AT&T System V provided in Altos UNIX 
System V. 
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sysdef 



output values of tunable parameters 
Syntax 



/etc/sysdef [ system_namelist [ conf ] ] 

Description 



The sysdef command outputs the values of all tunable parameters. It 
generates the output by analyzing the named operating system file 
(system namelist) and extracting the configuration information from 
the name list itself. 

Files 



/unix default operating system file (where the system 

namelist is) 

/etc/conf/* default directory containing master files 

See Also 



nlist(S) 

Diagnostics 



internal name list overflow 

If the master table contains more than an inter- 
nally specified number of entries for use by 
nlist(S). 

Standards Conformance 



sysdef is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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tcbck, smmck, authckrc 



trusted computing base checker 
Syntax 



tcbck 

Description 



tcbck checks the files in the trusted computing base for files that were 
caught in the process of being updated when the system went down, 
and for files that have been removed, tcbck is invoked by the scripts 
letclsmmck during system maintenance mode, and by letclauthckrc 
when the system enters multi-user mode. The check proceeds as fol- 
lows: 

1. letclsmmck runs tcbck to clean up any database files that were 
left in an interim state while being updated (files are created 
with -o (old) and -t (new) suffixes, respectively). When this 
process is interrupted, -o and -t files are left and must be recon- 
ciled before the system will function properly, tcbck checks 
the /etc/auth/system, /etc/auth/subsystems and 
/tcb/files/auth/* directories. If there are multiple versions of a 
file, the extra files are removed. When a -t file is found, the 
following is displayed: 

/etc/tcbck: file file missing, saved/iZe-t as file 

This message is repeated for all files found in that state in the 
specified directories. 

2. Next tcbck removes /etc/auth/system/pw_id_map and 
/etc/auth/system/gr_id_inap because the modification times of 
these files are compared with that of /etc/passwd and 
/etc/group and problems can occur when th system clock is 
reset. 

3. tcbck checks that key system files are present and that they are 
not of zero length. If a file is missing (or zero length) then a 
message similar to this is displayed: 

/etc/tcbck: file file is missing or zero length 
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This process is repeated for each of the following files: 

/etc/auth/system/defaultt 

/etc/auth/system/flles 

/etc/auth/system/devassign 

/etc/auth/system/ttys 

/etc/auth/sy stem/authorize t 

/tcb/files/auth/r/roott 

/etc/group 

/etc/passwdt 

When this process is complete, if any files were missing or -t files 
were substituted for real files, the following message is displayed: 

/etc/smtick: restore missing files from backup or distribution. 

4. If critical database files have been removed or corrupted (files 
marked with a dagger (t) in the previous file list are considered criti- 
cal) then the system enters maintenance mode automatically without 
asking for the root password. If no critical database files were lost, 
the system prompts for maintenance mode or normal operation, 

5. After the system goes to init level 2, letclauthckrc reinvokes tcbck to 
confirm that the files reported missing previously have been restored: 
Any missing files are listed, followed by this message: 

/etc/authckrc : Log in on the OVERRIDE tty and restore 

the missing files from a backup or the distribution disks. 

Missing files will have to be replaced when the system comes up 
multi-user. 

6. Finally authckrc prompts for checking the protected subsystem 
databases. If the response is yes, the authck{PsI>M) program is run. 

Value Added 



tcbck is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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timex 



time a command; report process data and system 
activity 

Syntax 



timex [ options ] command 

Description 



The given command is executed; the elapsed time, user time and sys- 
tem time spent in execution are reported in seconds. Optionally, pro- 
cess accounting data for the command and all its children can be listed 
or summarized, and total system activity during the execution interval 
can be reported. 

The output of timex is written on standard error. 
Options are: 

-p List process accounting records for command and all its children. 
This option works only if the process accounting software is 
installed. Suboptions f, h, k, m, r, and t modify the data items 
reported. The options are as follows: 

F*rint the fork/exec flag and system exit status columns in the 
output. 

Instead of mean memory size, show the fraction of total avail- 
able CPU time consumed by the process during its execution. 
This "hog factor" is computed as: 

(total CPU time)/(elapsed time). 

Instead of memory size, show total kcore-minutes. 

Show mean core size (the default). 

Show CPU factor (user time/(system-time + user-time). 

Show separate system and user CPU times. The number of 
blocks read or written and the number of characters transferred 
are always reported. 

-o Report the total number of blocks read or written and total char- 
acters transferred by command and all its children. This option 
works only if the process accounting software is installed. 



-f 
-h 

-k 
-m 
-r 
-t 
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-s Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All the data 
items listed in sar(C) are reported. 

See Also 

sar(ADM). 

Warning 

Process records associated with command are selected from the 
accounting file /usr/adm/pacct by inference, since process genealogy 
is not available. Background processes having the same user-id, 
terminal-id, and execution time window will be spuriously included. 

Examples 



A simple example: 

timex -ops sleep 60 

A terminal session of arbitrary complexity can be measured by timing 
a sub-shell: 

timex -opskmt sh 

session commands 
EOT 

Standards Conformance 

timex is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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graphics filters 
Syntax 



tplot [ -Tterminal [ -e raster ] ] 

Description 



This command reads plotting instructions [see plot(F)] from the stan- 
dard input and in general produces, on the standard output, plotting 
instructions suitable for a particular terminal. If no terminal is speci- 
fied, the environment parameter $TERM [see environ (M)] is used. 
Known terminal s are: 

300 

DASI 300. 
300S 

DASI 300s. 
450 

DASI 450. 
4014 

Tektronix 4014. 

ver 

VERSATEC D1200A. This version of plot places a scan- 
converted image in /usr/tmp/raster$$ and sends the result directly 
to the plotter device, rather than to the standard output. The -e 
option causes a previously scan-converted file raster to be sent to 
the plotter. 

Files 



/usr/lib/t300 

/usrAib/tSOOs 

/usr/lib/t450 

/usrAib/t4014 

/usrAib/vplot 

/usr/tmp/raster$ $ 

See Also 



plot(S), plot(F), term(M) 
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uadmin 

administrative control 
Syntax 

/etc/uadmin command function 

Description 



The uadmin command provides control for basic administrative func- 
tions. This command is tightly coupled to the System Administration 
procedures and is not intended for general use. It may be invoked only 
by the super-user. 

The arguments command and function are converted to integers and 
passed to the uadmin system call. 

See Also 



uadmin(S) 
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uconfig 



UNIX configuration manager 
Syntax 



/altos/bin/uconflg [-dltpDiyM] [-r root] [-m mdevice] [s sdevice.d] 
[-e meisa] 

Description 



uconfig is the top-level kernel configuration utility for ISA (PC/AT) 
and EISA bus systems. It is used to generate a new UNIX kernel, and 
perform other related system configuration tasks. On an EISA system, 
uconfig automatically configures the kernel to match the hardware. 

For an EISA system, uconfig must be run each time the system hard- 
ware is changed (for example, whenever an expansion board is added 
or removed, or an expansion board is moved from one EISA slot to 
another), uconfig should be invoked after first running the EISA Con- 
figuration Utility. (The EISA Configuration Utility is provided with 
your computer system on a separate Configuration diskette. Its use is 
described in the Owner's Guide for your system.) 

uconfig performs the following tasks: 

1. Modifies the kernel and device driver configuration files to 
match the hardware (EISA systems only). 

2. If an EISA hardware function exists but no mapping to an asso- 
ciated device driver exists in the meisa(F) file, uconfig prompts 
you for the driver name, and updates the meisa file accord- 
ingly. (Note: If no driver name is entered at this prompt, but 
only the Return key is pressed, uconfig ignores the unmapped 
function, and updates the meisa file so that this function is au- 
tomatically ignored the next time uconfig is invoked.) 

3. Runs inittab and node setup shell scripts (see meisa(F) and 
script specifications below) (EISA systems only). 

4. Sets up the slot_info file for use by pcM (ADM), the Port Con- 
figuration Utility (EISA systems only). 

5. Optionally (with -M), adjusts the kernel's tunable parameters 
to match the system memory size. 

6. Re-links the kernel. 
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7. Sets up the terminal database used by the system security ser- 
vices. 

After uconfig re-links the kernel, you must re-boot the system to 
activate the new kernel. 

If the ROOT environment variable is set to a valid path name, then all 
absolute path names are prefixed with the ROOT path. If the ROOT 
environment variable is undefined, and the -r option is not used, then 
the default is / (the root directory). 

Options 



-d Display hardware information only; no kernel configuration is 
done. 

-1 Suppress linking the kernel. However, all kernel files are still 
configured. 

-t Suppress setting up the protected terminal database. 

-p Suppress setting up the pcu slot_info file (EISA systems only). 

-D Debugging mode. Produce verbose diagnostic messages. 

-i Ignore all EISA hardware functions that are not mapped to a de- 
vice driver, that is, suppress asking for a driver name for such 
functions. Also, these functions are not added to the meisa file 
(EISA systems only). 

-y If the root directory is 7', assume 'y' to the questions that nor- 
mally appear (that is, "Should the kernel environment be 
built?" and "Use this as the default kernel on all boots?"). 
These questions are not displayed. 

-M Invoke idmemtune (ADM) to adjust the kernel tunable parame- 
ters to match the system memory size. 

-r root 

Specify an alternate root directory, below which other absolute 
path names are derived. This option overrides the ROOT 
environment variable. 

-m mdevice 

Specify an alternate mdevice file (the default file is 
roo?/etc/conf/cf.d/mdevice). 

-s sdevice.d 

Specify an alternate sdevice.d directory (the default directory is 
r<?or/etc/conf/sdevice.d). 
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-e meisa 

Specify alternate meisa file (default is roof/etc/conf/cf.d/meisa). 

Set-up Shell Scripts 



On an EISA system, uconfig performs extra system configuration tasks 
by invoking special shell scripts as described in this section. 

If specified in the meisa(F) file, uconfig will invoke the following 
Bourne Shell [sh(C)] scripts: 

roor/etc/conf/pack.d/xx;x/xicdnit 
ro<9r/etc/conf/pack.d/xxc/xccnode 

where xxx is the driver name specified in the meisa(F) file. The 
joccinit scripts are used to update the /etc/conf/init.d/xia: files (which 
are used to create the /etc/inittab file, as described in 
idmkinit (ADM)). The xxxnode scripts are used to update the 
/etc/conf/node.d/m; files (which are used to create the special /dev 
files, as described in idmknod(ADM)). These scripts will be run as 
many times as the associated entries in the sdevice(F) file. The sup- 
plied arguments are: lineno id type . 

The lineno argument is the relative position of the driver's entry in the 
sdeviccd/xxx file, starting at 0. The id argument is the EISA board ID, 
and type is the EISA function type string associated with the driver in 
the particular instance. These arguments may be used to determine, 
for example, which tty entries to make for a multi-port serial port 
expansion board. 

The xxmode scripts, in addition, can echo two numbers (for example, 
echo "$numl $num2") which are passed back into uconfig and 
recorded in the slot_info file for use by pcM (ADM). The two numbers 
$numl and $num2 should define a range to be used for tty numbers on 
a serial port expansion board. 

These shell scripts must not echo anything to stdout except as noted 
above. All error diagnostics should be directed to stderr. In addition, 
the exit status of the scripts must be 0 (zero) to indicate success, and 
non-zero to indicate failure. 

During the time when these shell scripts are invoked, the old 
r<9of/etc/conf/init.d/ja and roof/etc/conf/node.d/xx files, if they 
existed, are saved as ro<9f/etc/conf/init.d/jcx.sav and 
roof/etc/conf/node.d/xc.sav. These older files can be used by the shell 
scripts, if necessary, as a basis for building the new file. After all the 
scripts are run, the saved files are removed. 
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*/etc/conf/cf.d/meisa 

*/etc/conf/sdevice,d/* 

*/etc/slot_info 

See Also 



meisa(F), sdevice(F), idmemtune(ADM) 

Value Added 



uconfig is an extension to AT&T UNIX System V provided in Altos 
UNIX System V. 
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umount 

dismounts a file structure 

Syntax 

/etc/umount special-device 

Description 

umount announces to the system that the removable file structure pre- 
viously mounted on device special-device is to be removed. Any 
pending I/O for the file system is completed, and the file structure is 
flagged clean. For a detailed explanation of the mounting process, see 
mount (ADM). 

Files 

/etc/mnttab Mount table 

See Also 

mount(ADM), mount(S), mnttab(F) 

Diagnostics 

device busy An executing process is using a file on the named 
file system. 

Standards Conformance 

umount is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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upsconfig 



UPS shutdown configuration utility 
Syntax 



upsconfig [-i] [-p] [-tpwrtype] [-ffailtime] [-cpwrcnt] [-uupstime] 
[-wpwrtime] [-etermtime] [-dmaj,min] 

Description 



The upsconfig utility lets you change the configurable parameter set- 
tings that control how your system reacts in an uninterruptible power 
supply (UPS) power failure condition. Several parameter settings can 
be changed. TTie options to upsconfig are: 

-i Set parameters according to values found in the file 

/etc/upsparam. 

-p Display the current settings of all the configurable param- 

eters. 

-tpwrtype Set the UPS shutdown mode, pwrtype can be shutkill or 
shutsave. See the description of these two modes in the 
"Shutdown Modes" section below. 



-ffailtime The time in seconds to wait before checking again for a 
second power failure condition after the first power 
failure is detected. This setting is used to distinguish 
momentary power interruptions from total power failures. 
The default setting is 10. 

-cpwrcnt The maximum number of power failure interrupts that can 
occur within the time interval failtirne, after which the 
power source is considered unreliable. The default setting 
is 30. 



-uupstime The time in seconds that the UPS battery backup unit can 
operate reliably after power has been turned off. The 
default setting is 180. 

-wpwrtime The time in seconds for the system to wait after posting 
the SIGPWR signal to all processes before initiating shut- 
down procedures. The default setting is 30. 

-etermtime The time in seconds for the system to wait after posting 
the SIGTERM signal to all processes before posting the 
SIGKILL signal to all processes. The default setting is 



March 19, 1991 



UPSGONFIG-1 



UPSCONFIG (ADM) 



UPSCONFIG (ADM) 



20. This option is meaningful only if the shutkill mode is 
selected. 

-dmaj\min If the shutsave mode is selected, this option specifies the 
restart disk device in which the system memory image is 
to saved before the UPS turns its battery off. The major 
and minor device numbers, spearated by commas, are 
used to identify this hard disk area. Please note that a res- 
tart disk division must be allocated using divvy(ADM) 
before you can invoke upsconfig with this option. The 
disk device must be named restart and rrestart for the 
block and character special device files, respectively. The 
default major and minor device numbers are derived from 
the /dev/restart device, and should be ususally accepted. 

If upsconfig is invoked without any options, you are prompted for each 
of the settings described above. A null response followed by {Return) 
will leave the current configuration value the same. 

The -p option displays the current settings of all the configurable 
parameters described above. No other options are allowed to be given 
with the -p or -i options. 

A sanity check is performed on all of the values you enter. If the shut- 
down mode is shutkill, the total times of failtime , pwrtime , and the 
estimated disk output time cannot exceed the value of upstime . The 
estiamted disk output time will be displayed if the selected shutdown 
mode is shutsave, and the -p option is given. If there are any incon- 
sistencies, the following error message is displayed: 

Could not change parameters: Invalid argument 

Only the super-user is allowed to change any of these configurable 
parameters. 

Shutdown Modes 



There are two shutdown modes that can be selected: shutkill or shut- 
save. If the system is connected to a supported UPS, the following 
shutdown sequences take place after a power failure is detected, 
depending on which mode you have selected: : 

shutkill SIGPWR is sent to all processes, and then followed by 
SIGTERM and SIGKILL. The buffer cache is then flushed 
and all filesystems unmounted. The system then shuts off 
the UPS battery. When power is restored, the system per- 
forms a normal bootstrap to multiuser mode. 

shutsave SIGPWR is sent to all processes, and then the system mem- 
ory image, values of registers, and other machine states are 
all saved to the hard disk "restart device." The system then 
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shuts off the UPS battery. When power returns, the com- 
puter is restored to the saved state, allowing the system to 
restart and resume all processes as if power never halted. 

Notes 



The UPS parameters configured with upsconfig are saved across sys- 
tem reboots in the /etc/upsparam file. When upsconfig changes the 
parameters in the kernel, it also writes these values to the 
/etc/upsparam file. When the system is rebooted, the /etc/bcheckrc 
file executes upsconfig with the -i option, re-initializing the parame- 
ters in the kernel to tfie configured values. 

See Also 



upscfg(S), "Uninterruptible Power Supply Support" in the System 
Administrator's Guide. 

Value Added 



upsconfig is an extension to AT&T System V provided in Altos UNIX 
System V. 
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uucheck 



checks the uucp directories and permissions file 
Syntax 



/usr/Iib/uucp/uucheck [ -v ] [ -x debug_level ] 

Description 



uucheck checks for the presence of the uucp system required files and 
directories. It also checks for some obvious errors in tihe Permissions 
file (/usr/Iib/uucp/Permissions). When executed with the -v option, 
it gives a detailed explanation of how the uucp programs will interpret 
the Permissions file. The -x option is used for debugging, debug- 
option is a single digit in the range 1-9; the higher the value, the 
greater the detail. 

Note that uucheck can only be used by the super-user or uucp. 

Files 



/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usrAib/uucp/Maxuuscheds 

/usrAib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spooVuucppublic/* 

See Also 



uucico(ADM), uusched(ADM), uucp(C), uustat(C), uux(C) 

Notes 



The program does not check file/directory modes or some errors in the 
Permissions file such as duplicate login or machine name. 
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uucico 



file transport program for the UUCP system 
Syntax ^_ 



/usr/Iib/uucp/uucico [ -r role_number ] [ -x debug_level ] 
[ -i interface ] [ -d spool_directory ] [ -s ] [ -S ] system_name 

Description 



uucico is the file transport program for uucp work file transfers. Role 
numbers for the -r are the digit 1 for master mode or 0 for slave mode 
(default). The -r option should be specified as the digit 1 for master 
mode when uucico is started by a program or cron. uux and uucp both 
queue jobs that will be transferred by uucico. It is normally started by 
die scheduler, uusched , but can be started manually; this is done for 
debugging. For example, the shell uutry starts uucico with debugging 
turned on. A single digit must be used for the -x option with higher 
numbers for more debugging. 

The -i option defines the interface used with uucico. This interface 
only affects slave mode. Known interfaces are UNIX (default), TLI 
(basic Transport Layer Interface), and TLIS (Transport Layer Interface 
with Streams modules, read/write); only the default, UNIX, is applica- 
ble in this release. 

The -d option can be used to specify the spool directory: the default is 
lusrispoolluucp. 

If -s is specified, a call to the specified site is made even if there is no 
work for site sitename in the spool directory, but call only when times 
in the Systems file permit it. This is useful for polling sites that do 
not have the hardware to initiate a connection. 

The -S option can be used to specify the system name, overriding the 
call schedule given in the Systems file. For example, -S can be used 
to call a system which is said to be "Never" called in the Systems file. 
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Files 



UUCICO (ADM) 



/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usrAib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

See Also 



uusched(ADM), uutry(ADM), cron(C), uucp(C), uustat(C), uux(C) 
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uuclean 



UUCP spool directory clean-up 
Syntax 



/usr/Iib/uucp/uuclean [ -Ctime ] [ -Dtime ] [ -Wtime ] [ -Xtime ] 
[ -mstring ] [ -otime ] [ -ssystem ] [ -xdebug_level ] 

Description 



uuclean will scan the spool directories for old files and take appropri- 
ate action to remove them in a useful way: 

Inform the requestor of send/receive requests for systems that can not 
be reached. 

Return mail, which cannot be delivered, to the sender. 

Delete or execute mews for mews type files (depending on where the 
news originated -locally or remotely). 

Remove all other files. 

In addition, there is provision to wam users of requests that have been 
waiting for a given number of days (default 1). Note that uuclean will 
process as if all option times were specified to the default values 
unless time is specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days old will be 
removed with appropriate information to the requestor, 
(default 7 days) 

-Dtime Any D. files greater or equal to time days old will be 
removed. An attempt will be made to deliver mail mes- 
sages and execute mews when appropriate, (default 7 
days) 

-Wtime Any C. files equal to time days old will cause a mail mes- 
sage to be sent to the requestor warning about the delay in 
contacting the remote. The message includes the JOBID, 
and in the case of mail, the mail message. The adminis- 
trator may include a message line telling whom to call to 
check the problem (-m option), (default 1 day) 
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-Xtime Any X. files greater or equal to time days old will be 
removed. The D. files are probably not present (if they 
were, the X. could get executed). But if there are D. files, 
they will be taken care of by D. processing, (default 2 
days) 

-mstring This line will be included in the warning message gen- 
erated by the -W option. 

-otime Other files whose age is more than time days will be 
deleted, (default 2 days) The default line is "See your 
local administrator to locate the problem". 

-ssystem Execute for system spool directory only. 



-xdebugjevel 

The -X debug level is a single digit between 0 and 9; higher num- 
bers give more detailed debugging information. 

This program is typically started by the shell uudemon.clean, which 
should be started by cron(C). uuclean can only be executed by the 
super user or uucp. 



Files 



/usr/lib/uucp directory with commands used by uuclean 

internally 

/usr/spool/uucp spool directory 

See Also 



cron(C), uucp(C), uux(C) 
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uudemon: uudemon.admin, 
uudemon.clean, uudemon.hour, 
uudemon.poll, uudemon.poll2 

UUCP administrative scripts 

Description 

UUCP communications and file maintenance can be automated with 
the use of the uudemon.hour, uudemon.poll, uudemon.poll2, 
uudemon.admin, and uudemon.clean shell scripts. While in multi- 
user mode, cron scans files in /usr/spool/cron/crontabs once each 
minute for entries to execute at this time. An example crontabs file, 
crontab.eg, is provided to activate these daemons. The system 
administrator should copy these from /usr/lib/uucp to 
/usr/spool/cron/crontabs/uucp. To do this, log in as user uucp, edit 
the crontab.eg file to make any changes, and Uien enter the following 
command: 

crontab crontab.eg 

This will replace the original crontab entry. 



uudemon.admin 

The uudemon.admin shell script, as delivered, runs the uustat com- 
mand with -p and -q options. The -q reports on the status of work files 
(C), data files (D.), and execute files (X.) that are queued. The -p 
prints process information for networking processes listed in the lock 
files (/usr/spool/locks). It sends resulting status information to the 
UUCP administrative login (uucp) via mail. 

The default crontab entry for uudemon.admin is: 

48 10,14 * * 1 - 5 /bin/su uucp -c \ 

"/usr/lib/uucp/uudemon. admin" > /dev/null 

uudemon.clean 

The uudemon.clean shell script, as delivered, takes log files for indi- 
vidual machines from the /usr/spool/.Log directory, merges them, and 
places them in the /usr/spool/.Old directory with other old log infor- 
mation. If log files get large, the ulimit may need to be increased. It 
also removes work files (C.) 7 days or older, data files (D.) 7 days old 
or older, and execute files (X.) 2 days old or older from the spool files, 
uudemon.clean mails a summary of the status information gathered 
during the current day to the UUCP administrative login (uucp). 
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The default crontab entry for uudemon^lean is: 

45 23 * * * ulimit 5000; /bin/su uucp -c \ 

"/usr/lib/uucp/uudemon. clean" > /dev/null 

uudemon.hour 

The uudemon.hour shell script calls the uusched program to search 
the spool directories for work files (C.) that have not been processed 
and schedules these files for transfer to a remote machine. It then 
calls the uuxqt daemon to search the spool directories for execute 
files (X.) that have been transferred to your computer and were not 
processed at the time they were transferred. 

This is the default root crontab entry for uudemon.hour : 

39, 9 * * * * /usr/lib/uucp/uudemon. hour > /dev/null 
This script runs twice per hour (at 39 and 9 minutes past). 



uudemon.polI 

uudemon.poll uses the Poll (or the alternative PolLhour and 
PolLday) file (see poll(F)) for polling remote computers. The 
uudemon.poll script controls polling but does not actually perform 
the poll. It merely sets up a polling file (C.sysnxxxx) in the 
/usr/spool/uucp/nodename directory, where nodename is replaced by 
the name of the machine. This file will in turn be acted upon by the 
scheduler (started by uudemon.hour). The uudemon.poll script is 
scheduled to run twice an hour just before uudemon.hour so that the 
work files will be there when uudemon.hour is called. The default 
root crontab entry for uudemon.poll is as follows: 

1,30 * * * * "/usr/lib/uucp/uudemon. poll > /dev/null" 

uudemon.poll2 is an altemative to uudemon.poll, which uses a dif- 
ferent scheme and different poll files. Listing a site in the Poll file 
gives you control over the lower bound on number-of-calls-per-day (at 
least as many as you specify in Poll), but still no control on the upper 
bound. (This is because uudemon.poll uses the the time field of the 
Systems file, which is not suited to the purposes of polling). 
uudemon.poI12 permits much more precise control of scheduling. To 
use uudemon.poll!, you must remove the call to uusched from 
uudemon.hour, and run uudemon.poll! in place of uudemon.poll 
from cron. uudemon.poll! reads PolLhour (or Poll.day if called with 
the -d option) to determine whom to poll much like uudemon.poll, 
but calls uucico directly, using the -S option, thus overriding the time 
field of the Systems file. 
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Files 



UUDEMON (ADM) 



/usr/lib/uucp/Systems 

/usr/lib/uucp/uudemon.admin 

/usr/lib/uucp/uudemon.clean 

/usr/lib/uucp/uudemon.hour 

/usr/lib/uucp/uudemon.poU 

/usr/lib/uucp/uudemon.poll2 

/usr/Iib/uucp/PoU 

/usr/lib/uucp/Poll.hour 

/usr/lib/uucp/Poll.day 

See Also 



uusched(ADM) uucico(ADM), uuclean(ADM), cron(C), uucp(C), 
poll(F) systems(F) 

Standards Conformance 



uudemon is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 

uudemon.polI2 is an extension of AT&T System V provided in Altos 
UNIX System V. 



March 19, 1990 



UUDEMON-3 



UUGETTY(ADM) 



UUGETTY(ADM) 



uugetty 



set terminal type, modes, speed, and line discipline 
Syntax 



/usr/lib/uucp/uugetty [-t timeout] [-r] line [speed [type [linedisc] ] ] 
/usr/lib/uucp/uugetty -c file 

Description 



uugetty is a standard getty (M) modified to allow a tty line to be used 
by uucicOy cm, and ct\ that is, the line can be used in both directions, 
llie uugetty will allow users to login, but if the line is free, uucico, cu, 
or ct can use it for dialing out. The implementation depends on the 
fact that uucico, cu, and ct create lock files when devices are used. 
When the openQ returns (or the first character is read when -r option 
is used), the status of the lock file indicates whether the line is being 
used by uucico, cu, ct, or someone trying to login. Note that in the -r 
case, several <carriage-retum> characters may be required before the 
login message is output. The human users will be able to handle this 
slight inconvenience, uucico trying to login will have to be told by 
using the following login script: 

"" \r\d\r\d\r\d\r in:--in: . . . 

where the ... is whatever would normally be used for the login 
sequence. 

If there is a uugetty on one end of a direct line, there must be a uugetty 
on the other end as well. Here is an /etc/inittab entry using uugetty on 
an intelligent modem or direct line: 

30 :2:respawn: /usr/lib/uucp/uugetty -r -t 60 ttyOO 1200 

The meanings of the available options are: 

-t timeout 

Specifies that uugetty should exit if the open on the line succeeds 
and there is no response to the login prompt in timeout seconds. 
timeout is replaced by an integer. 

-r Causes uugetty to wait to read a character before it puts out the 
login message, thus preventing two uugettys from looping. An 
entry for an intelligent modem or direct line that has a uugetty on 
each end must use this option. 
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line 

Defines the name of the line to which uugetty will attach itself. 
The line name will point to an entry in tfie /dev directory. For 
example, /dev/ttyOO. 

speed 

Defines the entry to use from the /etc/gettydefs file. The entry 
defines the line speed, the login message, the initial tty setting, and 
the next speed to try if the user says the speed is inappropriate (by 
sending a break character). The default speed is 300. 

type 

Defines the type of terminal connected to the line. The default ter- 
minal is none, representing a normal terminal unknown to the sys- 
tem. 

linedisc 

Sets the line discipline to use on the line. The default is LDISCO, 
which is the only one currently compiled into the operating sys- 
tem. 

-cfile 

Checks the speed and tty definitions in file and sends the results to 
standard output. Unrecognized modes and improperly constructed 
entries are reported. For correct entries, flag values are printed. 
file is replaced by /etc/gettydefs or a similarly structured file. 

Files 



/etc/gettydefs 
/etc/issue 

See Also 



login(C), ct(C), cu(C), getty(M), init(M), uucico(ADM), tty(HW), 
ioctl(S), gettydefs(F), inittab(F) 

Notes 



ct will not work when uugetty is used with an intelligent modem such 
as penril or ventel. 
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uuinstall 



administers UUCP control files 
Syntax 



/etc/uuinstall [-r] 

Description 



The uuinstall program is used to manage the content of the control 
files used by the uucp communications system. It allows the user to 
change the contents of these files without using a text editor. The user 
need not know the detailed format of each of the control files, 
although he must be familiar with the function of the various fields 
within the files. These details are explained in the System 
Administrator's Guide . 

The uuinstall program can only be executed by the super-user. When 
invoked with the optional -r flag, uuinstall will not allow any of the 
files to be modified whether or not the user has made changes to the 
files. 

If uuinstall finds any of the required uucp control files missing from 
the system, it will create them with the correct access permissions and 
ownership. 

Flies 



/etc/systemid 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 

See Also 



mkuser(ADM) 
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uulist 



converts a UUCP routing file to MMDF format 
Syntax 



/usr/mmdf/table/tools/ uulist 

Description 



uulist is a conversion utility to produce MMDF-compatible UUCP rout- 
ing files from the UUCP routing file. 

After installing MMDF with custom, restore /usr/lib/uucp/Systems 
from backup media. Log in as root and run the conversion script 
lusrimmdfltableltoolsl uulist from the /usr/mmdf/table directory. You 
now have UUCP domain and channel files, uucp.dom and uucp.chn, 
in the current directory. Use the chown command to make these files 
owned by mmdf. Log out from the super user account. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. Log in as mmdf and run dbmbuild from 
/usr/mmdf/table. 

Files 



/usr/lib/uucp/Systems 

/usr/mmdf/table/uucp.chn 

/usr/mmdf/table/uucp.dom 

See Also 



dbmbuild(ADM), tables(F), "Setting Up Electronic Mail" in the Sys- 
tem Administrator's Guide 

Value Added 



uulist is an extension of AT&T System V provided in Altos UNDC Sys- 
tem V. 
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uusched 



the scheduler for the UUCP file transport program 
Syntax 



/usr/lib/uucp/uusched [ -x debug_level ] [ -u debug_level ] 

Description 



uusched is the uucp file transport scheduler. It is usually started by 
the daemon uudemon.hour that is started by cron(C) from an entry in 
lusrispoollcronlcrontabslroot: 

39,9 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour" > /dev/null 

The two options are for debugging purposes only; -x debug level will 
output debugging messages from uusched and -u debug level will be 
passed as -x debug level to uucico. The debug level is a number 
between 0 and 9; higher numbers give more detailed information. 

Files 



/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usrAib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

See Also 



uucico(ADM), cron(C), uucp(C), uustat(C), uux(C) 
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uutry 



tries to contact remote system with debugging on 
Syntax 



/usr/lib/uucp/uutry [ -x debug_level ] [ -r ] system_name 

Description 



The uutry program is a shell that invokes uucico to call a remote site. 
Debugging is automatically enabled at default level 5; -x overrides 
this value. If uutry successfully connects to the remote system, uutry 
stores the debugging output in the file /tmp/system, where system is 
the name of the remote system. In addition, uutry uses tail -f to print 
the last 10 lines of the debugging output to the standard output. 

To break out of the shell created by uutry , press DELETE or BREAK . 
This returns control to the terminal while uucico continues to run, 
sending the output to /tmp/system name. 

The -r option overrides the retry time in /usr/spool/uucp/.status. 

Files 



/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

/tmp/system_name 

See Also 



uucico(ADM), uucp(C), uux(C) 
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uuxqt 



executes remote command requests 
Syntax 



/usrAib/uucp/uuxqt [ -s system ] [ -x debug_level ] 

Description 



uuxqt is the program that executes remote job requests from remote 
systems generated by the use of the uux command. (Mail uses uux for 
remote mail requests), uuxqt searches the spool directories looking 
for X. files. For each X. file, uuxqt checks to see if all the required 
data files are available and accessible, and file commands are permit- 
ted for the requesting system. The Permissions file is used to validate 
file accessibility and command execution permission. 

There are two environment variables that are set before the uuxqt 
command is executed: 

UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 

These can be used in writing commands that remote systems can exe- 
cute to provide information, auditing, or restrictions. 

The -X debug Jevel is a single digit between 0 and 9. Higher numbers 
give more detailed debugging information. 

Files 



/usr/lib/uucp/Permissions 

/usrAib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

See Also 



uucico(ADM), uucp(C), uustat(C), uux(C), mail(C) 
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vddaemon 



virtual disk initialization 



Syntax 



vddaemon 

Description 



The virtual disk daemon, vddaemon, is started automatically by init 
whenever the operating system starts. This daemon initializes the sys- 
tem using information found in /etc/vdtab. It then sleeps in the back- 
ground, keeping the physical devices open for the virtual I/O. 

Files 



/dev/vd*, 
/dev/rvd*, 
/etc/vdtab, 
/etc/vdbadtab 

See Also 



add.vd(ADM), del.vd(ADM), vdinfo(ADM), vdutil(ADM) 

Value Added 



vddaemon is an extension of AT&T System V provided in Altos 
UNIX System V. 
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vdinfo 



display virtual disk information 
Syntax 



vdinfo [-v] [-k I -b dev name] I [-n vd num ] 

Description 



The vdinfo utility displays the current virtual disk set-up. 

Options 



The default option is to print information on all virtual disks currently 
set up in the system. See "Usage" below for details on output pro- 
duced by the default (no optional arguments) of vdinfo. 

-V Enable verbose mode. 

-k Display the size of disk dev name in 512-byte blocks. The 
specified disk may be a physical or virtual disk, and must be 
identified by its "raw" (character special) device filename (e.g., 
/dev/rhdbO for the second physical hard (disk 1), or /dev/rvdO 
for virtual disk 0). 

-b Display the following information about the specified device 
name, dev name, in this order: character or block file, major 
number, minor number, physical disk number, "virtual" drive 
number and division number. Note that the "virtual" drive 
number in this sense means the hard disk partition number. 

-n Display information for virtual disk number vdjium only. 

Usage 



The default option with the verbose option only (i.e., vdinfo -v) dis- 
plays information on each virtual disk in columns. Displaying all the 
existing virtual disks might take a few seconds since it has to search 
through /dev to gather all the physical device names. The time it 
takes depends on the number of virtual disks in the system. 

The default option without the verbose option (i.e., simply vdinfo) dis- 
plays information about all the existing virtual disks. Each line 
represents a single striped or mirrored virtual disk. 
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Here is the format of the default output produced by vdinfo : 

vdmm S stripsz phys dev ... [ : mvdnum M mstripsz mphys dev ... ] 

where: 

vdmm 

represents the primary virtual disk number. 

S indicates striping, which is always present if the system con- 
tains a virtual disk. Virtual disks that are mirrored only also 
contain this S character, since they are considered * 'striped" 
between the primary virtual disk and the mirror disk. See 
"Usage" below. 

stripsz 

represents the stripe size (in 1024-byte blocks) of the primary 
virtual disk. 

physdev 

is a list of the physical devices that comprise the primary vir- 
tual disk. 

: is an optional character that, if present, indicates that this vir- 
tual disk is also striped. The information following the colon 
describes the mirror part(s) of the virtual disk. Otherwise, this 
virtual disk is striped only. 

mvdnum 

represents the mirror virtual disk number. 
M represents mirroring. 
mstripsz 

represents the stripe size (in 1024-byte blocks) of the mirror 
disk. 

mphysdev 

is a list of the physical devices that comprise the mirror disk. 

Note that the only difference between a "mirrored" disk and a 
"striped and mirrored" disk is that a mirrored disk has only one de- 
vice in the primary virtual disk. Otherwise they are exactly the same. 

Examples 



The following default vdinfo output (with no options) indicates that 
the there is only one virtual disk (/dev/vdO, or simply virtual disk 0), 
and that it is striped between physical devices /dev/hdblO, 
/dev/hdclO, and /dev/hddlO, with a stripe size of 16 KB: 
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% vdinfo 

0 S 16 /dev/hdblO /dev/hdclO /dev/hddlO 

Using vdinfo -b as shown below produces output that indicates the de- 
vice name /dev/hdcO is a block special device file with a major num- 
ber of 64 and a minor number of 64, and that it is located at physical 
disk number 2, partition ("virtual disk") number 0 (all partitions on 
the disk), and division number 0 (the first division). 

% vdinfo -b /dev/hdcO 
b 64 64 1 0 0 

The following shows how you can use vdinfo -b with a virtual disk 
device name instead of a physical device name as used in the above 
example. Note also that the "raw" device name is used, thus display- 
ing the character "c" file data. 

% vdinfo -b /dev/rvdO 
c 25 0 0 0 0 

The following vdinfo output shows how virtual disk 1 (/dev/vdO) is set 
up. The two vdinfo commands are shown to illustrate the effect of the 
-V "verbose" option (remember that the "virtual" label indicates the 
partition number): 

% vdinfo -b /dev/vdO 
b 25 0 0 0 0 

% vdinfo -V -b /dev/vdO 

/dev/vdO (25,0) : block device, physical = 0, virtual = 0, diwy = 0 

The following vdinfo command illustrates the use of the -k option 
with the virtual disk number 0. Note that the -k option requires the 
character-based special device filename (rvdO): 

% vdinfo -k /dev/rvdO 
516000 

You can also use vdinfo -b to learn the sizes of the individual filesys- 
tems that make up the virtual disk: 

% vdinfo -k /dev/rhdblO 
174078 

% vdinfo -k /dev/rhdclO 
172030 

% vdinfo -k /dev/rhddlO 
174002 

The following vdinfo output indicates that the first virtual disk (virtual 
disk 0) is both striped and mirrored. The primary virtual disk is 
striped between physical devices /dev/hdblO and /dev/hdclO, with a 
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stripe size of 16 KB. The primary disk is mirrored with the second 
virtual disk (/dev/vdl, or simply virtual disk 1). This disk is striped 
between physical devices /dev^iddlO and /dev/hdelO, with a stripe 
size of 16 K: 

0 S 16 /dev/hdblO /dev/hdclO : 1 M 16 /dev/hddlO /dev/hdelO 

The following vdinfo output indicates that virtual disk 0 (the first vir- 
tual disk) is mirrored only (with virtual disk 1). Note that there is only 
one physical device, /dev/hdblO, in the primary virtual disk; this indi- 
cates that the primary virtual disk is mirrored only, and not striped. 
The 'S' character and stripe sizes values (in this case 16 for both pri- 
mary and mirror disks) are always present on virtual disks. 

This output line specifically indicates that virtual disk 0 (physical de- 
vice /dev/hdblO) is mirrored with virtual disk 1 (physical device 
/dev/hdclO). 

0 S 16 /dev/hdblO : 1 M 16 /dev/hdclO 

Files 



/dev/vd*, 
/etc/rvd*, 
/etc/vdtab 

See Also 



add.vd(ADM), 
del.vd(ADM), 
vddaemon(ADM) 
vdutil(ADM) 

Notes 



Physical device names are obtained by matching the device numbers 
with files that appear in the /dev directory. If the name is not found, 
then the major and minor device number pair is displayed instead. 

Value Added 



The vdinfo utility is an extension of AT&T System V provided in 
Altos UNIX System V. 
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vdutil 



virtual disk utility 
Syntax 



/altos/bin/vdutil 

Description 



vdutil is a menu-driven program that performs maintenance tasks 
required to display, add, delete, or fix striped and mirrored virtual 
disks, vdutil provides a front-end interface for various other virtual 
disk commands and files, including vdinfo, add.vdy del.vd, and 
vdbadblk. You should use vdutil for all virtual disk administration 
tasks. 

vdutil performs five basic tasks: 

• display virtual disk information 

• add a virtual disk 

• remove a virtual disk 

• fix a mirrored virtual disk 

• display any bad physical blocks, or components of a mirrored 
virtual disk 

When adding, deleting or fixing a virtual disk, the system must be in 
single-user mode. However, you may use vdutil to display virtual disk 
information while the system is in any mode. 

Detailed descriptions of these five tasks are provided in ±e following 
sections. 

Display Virtual Disk Information 

Virtual disk information may be displayed for a specific virtual disk, 
or for all existing virtual disks. The displayed information includes 
the following: 

Whether the disk is a mirrored or striped disk. 

The underlying components (which may be physical disk divisions, or 
other virtual disks). 
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The block size (in 512 byte blocks). 
Add a Virtual Disk 

When adding a virtual disk, vdutil asks several questions. Refer to 
System Administrator's Guide for complete information on this pro- 
cedure. 

Delete a Virtual Disk 

To delete a virtual disk, the user is asked to specify which virtual disk 
should be removed, vdutil will then remove the associated devices, 
delete the entry from /etc/vdtab, and (if necessary) delete any associ- 
ated entry in the mount table. 

Fix a Mirrored Virtual Disk 

When selecting this option of vdutil, you will be asked which virtual 
disk to repair. You may specify any valid mirrored disk (or a for all 
mirrored disks). The remainder of this procedure is then automated. If 
any physical component has recorded just a few bad blocks, then those 
bad blocks will be repaired (using badtrk(ADM)\ and the good data 
will be restored. If there have been "too many" errors, the whole phy- 
sical component will have been disabled, and some external method of 
repair (or replacement) should be used. If this has already been done, 
then the whole component will be re-mirrored, and the component 
will be brought back into service. Note that in this case, the copying of 
the good data may take some time. 

Display Bad Block Information on a Mirrored Virtual Disk 

When selecting this option of vdutil, you will be asked which virtual 
disk to display. You may specify any valid mirrored disk (or a for all 
mirrored disks). Any corresponding bad block information will be dis- 
played. If a physical component has been disabled due to "too many" 
errors, then this will be noted also. If so, then external action should 
be taken to remedy this situation, before selecting the option to Fix a 
Virtual Disk. 

See Also 



add.vd(ADM), del.vd(ADM), vdinfo(ADM), "Virtual Disks" in the 
System Administrator's Guide 

Value Added 



vdutil is an extension of AT«feT System V provided in Altos UNIX Sys- 
tem V. 
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vectorsinuse 



displays the list of vectors currently specified in the 
sdevice file 

Syntax 



/etc/conf/cf.d/vectorsinuse 

Description 



This script searches the sdevice file and displays a list of the interrupt 
vectors already in use. 

You must move to the /etc/conf/cf.d to execute vectorsinuse. 

When installing a device driver with the Link Kit, you can use 
vectorsinuse to find an available interrupt vector for the driver. When 
you invoke the configure program to modify the system configuration 
files with the new driver information, use the -v option to indicate the 
vectors on which this device interrupts. 

The -V option to configure performs a function similar to that of 
vectorsinuse. You specify a particular vector on which the device is 
capable of interrupting (refer to the device's hardware manual), and 
configure tells you if another device is akeady using that interrupt 
vector. 

Files 



/etc/conf/cf.d/sdevice 

See Also 



configure(ADM), sdevice(F), "Adding Device Drivers with the Link 
Kit' ' in the System Administrator's Guide 

Value Added 



vectorsinuse is an extension to AT&T System V provided in Altos 
UNIX System V. 
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volcopy 



make literal copy of UNIX filesystem 
Syntax 



/etc/volcopy [options] fsname srcdevice volnamel destdevice vol- 
name2 

Description 



The volcopy command makes a literal copy of the UNIX filesystem 
using a blocksize matched to the device. Options are: 

-a invoke a verification sequence requiring a positive operator 
response instead of the standard 10-second delay before the 
copy is made 

-s (default) invoke the DEL if wrong verification sequence. 

The program requests length and density information if it is not given 
on the command line or is not recorded on an input tape label. If the 
filesystem is too large to fit on one reel, volcopy will prompt for addi- 
tional reels. Labels of all reels are checked. Tapes may be mounted 
alternately on two or more drives. If volcopy is interrupted, it will ask 
if the user wants to quit or wants a shell. In the latter case, the user 
can perform other operations (e.g., labelit) and return to volcopy by 
exiting the new shell. 

The fsname argument represents the mounted name (e.g., root, ul, 
etc.) of the filsystem being copied. 

The srcdevice or destdevice should be the physical disk section or tape 
(e.g.: /dev/dsk/Osl etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and 
should match the external label sticker. Such label names are limited 
to six or fewer characters, volname may be - to use the existing vol- 
ume name. 

srcdevice and volnamel are the device and volume from which the 
copy of the filesystem is being exti-acted. destdevice and volnamel 
are the target device and volume. 

fsname and volname are recorded in the last 12 characters of the super 
block (char fsname[6], volname[6];). 
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/etc/log/ filesave.log a record of filesystems/volumes copied 

See Also 



labelit(ADM), sh(C), filesystem(F) 

Standards Conformance 



volcopy is conformant with: 
AT&TSVID Issue 2, Select Code 307-127. 
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wall 

writes to all users 

Syntax 

/etc/wall 

Description 

wall reads a message from the standard input until an end-of-file. It 
then sends this message to all users currently logged in preceded by 
"Broadcast Message from wall is used to warn all users, for 
example, prior to shutting down the system. 

The sender should be super-user to override any protections the users 
may have invoked. 

Files 

/dev/tty* 

See Also 

mesg(C), write(C) 

Diagnostics 

Cannot send to ... The open on a user's tty file has failed. 
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wtinit 



object downloader for the 5620 DMD terminal 
Syntax 



/usr/lib/layersys/ wtinit [-d] [-p] file 

Description 



The wtinit utility downloads the named file for execution in the AT&T 
TELETYPE 5620 DMD terminal connected to its standard output, file 
must be a DMD object file, wtinit performs all necessary bootstrap 
and protocol procedures. 

There are two options: 

-d Prints out the sizes of the text, data, and bss portions of the down- 
loaded file on standard error. 

-p Prints the downloading protocol statistics and a trace on standard 
error. 

The environment variable JPATH is the analog of the shell's PATH 
variable to define a set of directories in which to search for file. 

If the environment variable DMDLOAD has the value hex, wtinit will 
use a hexadecimal download protocol that uses only printable charac- 
ters. 

Terminal Feature Packages for specific versions of AT&T windowing 
terminals will include terminal-specific versions of wtinit under those 
installation sub-directories, /usr/lib/layersys/ wtinit is used for 
layersiC) initialization only when no Terminal Feature Package is in 
use. 

Diagnostics 



Returns 0 upon successful completion, 1 otherwise. 
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Notes 

Standard error should be redirected when using the -d or -p options. 

See Also 

layers(C) 
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xbackup 



performs XENIX incremental filesystem backup 
Syntax 



xbackup [ key [ arguments ] filesystem ] 

Description 



xbackup copies all files changed after a certain date in the date in the 
filesystem . xbackup is used for XENIX filesystems; use backup(ADM) 
for UNIX filesystems. The key specifies the date and other options 
about the xbackup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described 
below: 

f Places the xbackup on the next argument file instead of the 
default device. 

u If the xbackup completes successfully, writes the date of the 
beginning of the xbackup to the file /etc/ddate. This file records 
a separate date for each file system and each xbackup level. 

0-9 This number is the "xbackup level". Backs up all files 
modified since the last date stored in the file /etc/ddate for the 
same file system at lesser levels. If no date is determined by the 
level, the beginning of time is assumed; thus the option 0 causes 
the entire file system to be backed up. 

s For xbackups to magnetic tape, the size of the tape is specified 
in feet. The number of feet is taken from the next argument. 
When the specified size is reached, xbackup will wait for reels 
to be changed. The default size is 2,300 feet. 

d For xbackups to magnetic tape, the density of the tape, 
expressed in BPI, is taken from the next argument. This is used 
in calculating the amount of tape used per write. The default is 
1600. 

k This option is used when backing up to a block-structured de- 
vice, such as a floppy disk. The size (in K-bytes) of the volume 
being written is taken from the next argument. If the k argument 
is specified, any s and d arguments are ignored. The default is 
to use s and d. 
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If no arguments are given, the key is assumed to be 9u and a default 
file system is backed up to the default device. 

The first xbackup should be a full level-0 xbackup: 

xbackup Ou 

Next, periodic level 9 xbackups should be made on an exponential 
progression of tapes or floppies: 

xbackup 9u 

This progression is shown as follows: 

1 2 1 3 1 2 1 4 ... 

where xbackup 1 is used every other time, xbackup 2 every fourth, 
xbackup 3 every eighth, etc.) When the level-9 incremental xbackup 
becomes unmanageable because a tape is full or too many floppies are 
required, a level- 1 xbackup should be made: 

xbackup lu 

After this, the exponential series should progress as if uninterrupted. 
These level-9 xbackups are based on the level- 1 xbackup, which is 
based on the level-0 full xbackup. This progression of levels of 
xbackups can be carried as far as desired. 

The default file system and the xbackup device depend on the settings 
of the variables DISK and TAPE, respectively, in the file 
/etc/default/backup. 



/etc/default/backup Default xbackup information 

See Also 



cpio(C), default(F), xdumpdir(ADM), xrestore(ADM), restore(ADM), 
sddate(C), backup(ADM), xbackup(F), System Administrator's Guide 



Files 



/etc/ddate 



Records xbackup dates of file system/level 
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If the xbackup requires more than one volume (where a volume is 
likely to be a floppy disk or tape), you will be asked to change vol- 
umes. Press RETURN after changing volumes. 

Notes 



Sizes are based on 1600 BPI for blocked tape; the raw magnetic tape 
device has to be used to approach these densities. Write errors to the 
xbackup device are usually fatal. Read errors on the file system are 
ignored. 

If the default archive medium specified in /etc/ default/ xbackup or 
/etc/ default/ restor is block structured, (i.e. floppy disk) then the vol- 
ume size in Kbytes must be specified on the command line. Neither 
utility works correctly without this information. For example, using 
the default device (below) with the xbackup command, enter the fol- 
lowing: 

xbackup k 360 

The default device entry for /etc/ default/ xbackup (tape=/dev/xxx) and 
/etc/ default/ restor (archive=/dev/xxx) is /dev/rfd)2. 

It is not possible to successfully restore an entire active root file sys- 
tem. 



Warning 



When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a xbackup. You must also be sure to 
close the floppy door when inserting floppy disks. If you fail to do so 
in a multi-floppy xbackup, the entire xbackup will fail and you will 
have to begin again. 

You should never xbackup more than one filesystem to the tape de- 
vices /dev/nrctO and /dev/nrct2. This is because, although xbackup 
can write more than one filesystem to /dev/nrctO or /dev/nrctl, restore 
may not be able to restore more than one filesystem from these de- 
vices. 

Value Added 

xbackup is an extension of AT&T System V provided in Altos UNIX 
System V. 



March 15, 1989 XBACKUP-3 



XDUMPDIR(ADM) 



XDUMPDIR (ADM) 



xdumpdir 



prints the names of files on a XENIX backup archive 
Syntax 



xdumpdir [ f filename ] 

Description 



xdumpdir is used to list the names and inode numbers of all files and 
directories on an archive written with the xbackup command. This is 
most useful when attempting to determine the location of a particular 
file in a set of backup archives. 

The f option causes filename to be used as the name of the backup de- 
vice instead of the default. The backup device depends on the setting 
of the variable TAPE in the file /etc/default/xdumpdir. The device 
specified as TAPE can be any type of backup device supported by the 
system (for example, a floppy drive or cartridge tape drive). 

Files 



rst* Temporary files 

See Also 



xbackup(ADM), xrestore(ADM), default(F) 

Value Added 



xdumpdir is an extension of AT&T System V provided in Altos UNIX 
System V. 
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xinstall 

XENIX installation shell script 

Syntax 

/etc/xinstall [ device ] 

Description 

/etc/xinstall is the sh(C) script used to install XENIX distribution (or 
application program) floppies. It performs the following tasks: 

- Prompts for insertion of floppies. 

- Extracts files using the tar(C) utility. 

- Executes /once/init.* programs on each floppy 
after they have been extracted. 

- Removes any /once/init.* programs when the 
installation is finished. 

The optional argument to the command specifies the device used. The 
default device is /dev/xinstall and is normally linked to 
/dev/rdsk/f0ql5dt. 

Files 

/etc/xinstall 
/once/init.* 

See Also 

custom(ADM), fixperm(ADM), installpkg(ADM) 

Notes 

xinstall is provided for use with any existing XENIX packages you 
may have that you wish to install on a UNIX system, xinstall does not 
work with UNIX system applications [use installpkg{ADM) to install 
UNIX system applications]. 



March 15, 1989 



XINSTALL-1 



XINSTALL(ADM) XINSTALL (ADM) 

Value Added 

xinstall is an extension of AT&T System V provided in Altos UNIX 
System V. 
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xprsetup 



transparent printer setup utility 
Syntax 



xprsetup [ -a ] 
xprsetup -d xprnum 
xprsetup -s xprnum 

Description 



The xprsetup utility sets the transparent print mapping for entries 
listed in the xprtab(F) file. Entries may be made in the xprtab file 
using pcM(ADM). xprsetup is called automatically on transition from 
single user to multi-user state. Also, pcu calls xprsetup whenever it 
makes a change to the system's transparent printer setup. 

The first form of the command performs a kernel transparent print 
map setup for all entries in the xprtab file unless the -a option is 
given (see below). 

Options 



The options to xprsetup are: 

-a With this option, xprsetup displays the transparent print map 
currently in effect in the kernel for all transparent printer nodes. 
Transparent printer node pathnames are of the form 
/dev/xpr/xprXX' where XX is in the range 01 through 99. 

-d With this option, xprsetup displays the transparent print map 
currently in effect in the kernel for transparent printer node 
xprnum. The argument xprnum must be a decimal number in the 
range 1 through 99. 

-s This option performs a kernel transparent print map setup for tran- 
sparent printer node xprnum as specified in the xprtab file. If no 
entry exists for xprnum in the xprtab file then any current kernel 
transparent print map setup for transparent print node xprnum is 
canceled. The argument xprnum must be a decimal number in the 
range 1 through 99. 
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/etc/xprtab 

/dev/xpr/xpr?? 

/etc/rc.d/6/xprinit 

See Also 



pcu(ADM), xprtab(F), xprcat(C) 

Value Added 



xprsetup is an extension to AT&T UNIX System V provided in Altos 
UNIX System V. 
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invokes XENIX incremental filesystem restorer 
Syntax 



xrestore key [ arguments ] 
xrestor key [ arguments ] 

Description 



xrestore is used to read archive media backed up with the 
xbackup{kYyM) command. 

The key specifies what is to be done. Key is one of the characters cC, 
rR, tT, or xX optionally combined with k and/or f or F. restor is an 
alternate spelling for the same command. 

c,C 

Verify (check) a dump tape. Used after a dump is made to make 
sure file tape has no I/O errors or bad checksums. C is the same as 
c except that it provides a higher level of checking. 

f Uses the first argument as the name of the archive (backup device 
/dev/*) instead of the default. 

F F is the number of the first file on the tape to read. All files up to 
that point are skipped. 

k Follow this option with the size of the backup volume. This allows 
for reading multivolume dumps from media such as floppies. 

r,R 

The archive is read and loaded into the file system specified in 
argument. This should not be done lightly (see below). If the key 
is R, xrestore asks which archive of a multivolume set to start on. 
This allows xrestore to be interrupted and then restarted (an fsck 
must be done before the restart). 

t Prints the date the archive was written and the date the file system 
was backed up. 

T Prints a full listing of a dump tape. Similar to t. 

X Each file on the archive named by an argument is extracted. The 
filename has all "mount" prefixes removed; for example, if /usr is 
a mounted file system, /usr/bin/lpr is named /bin/lpr on the 
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archive. 

The extracted file is placed in a file with a numeric name supplied 
by xrestore (actually the inode number). In order to keep the 
amount of archive read to a minimum, the following procedure is 
recommended: 

1. Mount volume 1 of the set of backup archives. 

2. Type the xrestore command with the appropriate key and argu- 
ments. 

3. xrestore will check xdumpdir, then announce whether or not it 
found the files, give the numeric name that it will assign to the 
file, and in the case of a tape, rewind to the start of the archive. 

4. It then asks you to "mount the desired tape volume". Type the 
number of the volume you choose. On a multivolume backup, 
the recommended procedure is to mount the last through the 
first volumes, in that order, xrestore checks to see if any of the 
requested files are on the mounted archive (or a later archive, 
thus the reverse order). If the requested files are not there, xre- 
store doesn't read through the tape. If you are working with a 
single-volume backup or if the number of files being xrestored 
is large, respond to the query with 1 and xrestore will read the 
archives in sequential order. 

X Same as x except that files are replaced in original location. When 
you use this option, omit the initial slash ( / ) in the filename on the 
xrestore command line. 

The r option should only be used to xrestore a complete backup 
archive onto a clear file system, or to xrestore an incremental backup 
archive onto a file system so created. It should not be used to xrestore 
a backup archive onto the root file system. Thus: 

/etc/mkfs /dev/hdl 10000 
xrestore r /dev/hdl 

is a typical sequence to xrestore a complete backup. Another xrestore 
can be done to get an incremental backup in on top of this. 

A xbackup followed by a mkfs and a xrestore is used to change the 
size of a file system. 
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XRESTORE (ADM) 



rst* Temporary files 

/etc/default/restor Name of default archive device 

The default archive unit varies with installation. 

Notes 



It is not possible to successfully xrestore an entire active root file sys- 
tem. 

Note also that xrestore may be unable to xrestore more than one 
filesystem from the tape devices IdevlnrctO and Idevlnrctl. 

Diagnostics 



There are various diagnostics involved with reading the archive and 
writing the disk. There are also diagnostics if the i-list or the free list 
of the file system is not large enough to hold the dump. 

If the dump extends over more than one disk or tape, xrestore may ask 
you to change disks or tapes. Reply with a newline when the next unit 
has been mounted. 

See Also 



xbackup(ADM), xdumpdir(ADM), fsck(ADM), mkfs(ADM), 
sddate(C) 

Value Added 



xrestor and xrestore are extensions of AT&T System V provided in 
Altos UNIX System V. 
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xts 



extract and print xt driver statistics 
Syntax 



xts [-f] 

Description 



The xts command is a debugging tool for the jc/(HW) driver. It per- 
forms an XTIOCSTATS ioctl(S) call on its standard input file to 
extract the accumulated statistics for the attached group of channels. 
This call will fail if statistics have not been configured in the driver, 
or the standard input is not attached to an jc/(HW) channel. The statis- 
tics are printed one item per line on the standard output. 

-f Causes a "formfeed" character to be put out at the end of 

the output for the benefit of page-display programs. 

Diagnostics 



Returns 0 upon successful completion; 1 otherwise. 

See Also 



xtd(ADM), xtt(ADM), xt(HW), ioctl(S), xtproto(M) 
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xtt 



extract and print xt driver packet traces 
Syntax 



xtt [-n [-0] 

Description 



The xtt command is a debugging tool for the xt(HW) driver. It per- 
forms an XTIOCTRACE ioct^S) call on its standard input file to turn 
on tracing and extract the circular packet trace buffer for the attached 
group of channels. This call will fail if tracing has not been config- 
ured in the driver, or the standard input is not attached to an x/(HW) 
channel. The packets are printed on the standard output. 

The optional flags are: 

-f Causes a "formfeed" character to be put out at the end of the out- 
put for the benefit of page-display programs. 

-o Turns off further driver tracing. 

Diagnostics 



Returns 0 upon successful completion; 1 otherwise. 

Note 



If driver tracing has not been turned on for the terminal session by 
invoking layerslC) with the -t option, xtt will not generate any output 
the first time it is executed. 

See Also 



layers(C), xtd(ADM), xts(ADM), xt(HW), ioctl(S), layers(M) 
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SS?'^^^^^ V/386 
(HW) Hardware 



Contents 



Hardware Dependent (HW) 



Intro introduction to machine related miscellaneous fea- 
tures and files 

audit audit subsystem interface device 

boot UNIX boot program 

cdrom compact disk devices 

cmos displays and sets the configuration data base 

fd floppy devices 

hd internal hard disk drive 

keyboard the keyboard 

Ip, IpO line printer device interfaces 

mouse system mouse 

parallel parallel interface devices 

prf operating system profiler 

ramdisk memory block device 

rtc real time clock interface 

screen tty[01-n], color, monochrome, ega, vga display 

adapter and video monitor 

scsi small computer systems interface 
serial: ttyl[a-h] , 
ttyl[A-H] , 
tty2[a-h] , 

tty2[A-H] interface to serial ports 

tape magnetic tape device 

terminal login terminal 

xt multiplexed tty driver for AT&T windowing 
terminals 
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Intro 



introduction to machine related miscellaneous features 
and files 

Description 



The hardware-dependent section (HW) contains information useful in 
maintaining the system. Included are descriptions of files, devices, 
tables and programs that are important in maintaining the entire sys- 
tem. 
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audit subsystem interface device 
Description 



The audit subsystem provides two minor devices for interfacing to the 
audit subsystem. One device, /dev/auditr, is used exclusively by the 
audit daemon, auditd(ADM), for the purpose of reading the subsystem 
audit collection file records. The other device, /dev/auditw, is used by 
application programs which are privileged to write audit records to the 
audit subsystem. This device may be opened by as many applications 
as is necessary but may only be opened for writing. The device also 
support a host of ioctl(S) functions to perform audit subsystem control. 

The audit read device provides the usual character device driver 
open(S), read(S), and close(S) routines. Writing to this device is not 
permitted. Read requests are satisfied by the subsystem and optimize 
the efficiency of the daemon and the performance of the system. Read 
requests are satisfied when sufficient data has accumulated to meet an 
administrator specified threshold. Until the data is available, the read 
request will block. In this manner, the daemon will receive suffi- 
ciently large blocks of data on each read to allow sufficient compac- 
tion. Also, context switch frequency is greatly reduced since the reads 
will not be satisfied on small blocks or when no data is available. 

The audit write device provides an interface to the audit subsystem for 
applications that have the vtriteaudit privilege. The device supports 
the openR(S), close(S), write(S), and ioctl{S) entry points. Once 
opened, an application may compose an audit record and write(S) it to 
the device for inclusion in the collection file. The writing of an audit 
record is an atomic action in that the entire record must be presented 
to the subsystem with a single write. It is incumbent on the application 
to gather the record into a single buffer before writing it to the device. 

The format of an audit record depends upon the type of event being 
audited. All audit records begin with a common audit record header 
defined by the audit_header structure in the file sysaudit.h. 

struct audit header { 



ushort 


rec_length; 


/* 


total record length */ 


tinie_t 


tstaitp; 


/* 


date/time of record */ 


ulong 


event id; 


/* 


event sequence id */ 


ushort 


event_type; 


/* 


event classification */ 


ushort 


record type; 


/* 


record format */ 


ushort 


obj_type; 


/* 


object type */ 


ushort 


pid; 


/* 


process_id */ 



}; 

The event type, recordjype, and pid fields must be filled by the 
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application; all other fields are filled by the Audit subsystem. The 
event types are defined in the header file and provide a method of 
categorizing audit records into groups such as Login events or System 
Administrator events. The record type informs the subsystem of the 
record template type. This information is also retained with the record 
when it is written to the collection file by the subsystem since it is 
required at data reduction time. 

Some of the record types have variable length string areas that follow 
the fixed portion of the audit record. Each text string that is part of the 
record has its size recorded in a count field. Each string is null- 
terminated and the count must include the null character. When the 
record is written to the device, the amount of data written includes the 
fixed portion plus all text strings. The supported record types for 
application programs are: 



RT_LOGIN 

RT_PASSWORD 

RT_DATABASE 

RT_SUBSYSTEM 

RT_LOCK 

RT AUDIT 



loginAogofiF events 
password modifications 
protected database modifications 
privileged subsystem events 
terminal and account locking 
audit subsystem events 



Each record type indicates a unique record structure definition. The 
RT_LOGIN record uses the login_audit structure. It contains the fol- 
lowing fields, defined in sys/audit.h: 



struct login_audit { 

struct audit header 



char 
ushort 
ushort 
ushort 
dev_t 
ptr_t 
ptr_t 
#ifdef Bl 

ptr_t 

#endif 

}; 



usernartie[8] 

code; 

luid; 

rgid; 

ttyd; 

cdir; 

terminal; 

sec level; 



aud_hdr; 

/* login name */ 

/* function code */ 

/* login userid */ 

/* real gid */ 

/* controlling terminal */ 

/* current directory */ 

/* stdin terminal name */ 

/* login sensitivity level */ 



Username is the login or logoff user account name. The luid and rgid 
fields are those associated with the specified user account. The audit 
header, which precedes the login specific portion of the record, must 
have the record Jype field set to RT_LOGIN. The event type used 
for login/logoff is the ET LOGIN event. 
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The code field is used to distinguish between specific actions that may 
fall into a common category. For instance, the ET_LOGIN event 
category includes both successful and unsuccessful logins, and also 
logoffs. The code values, defined in the header file, indicate which of 
these occurred. 

The login audit record also contains two variable length text strings. 
These are the login terminal and the process current directory. 'Hie 
string area begins immediately following the fixed portion of the 
record. The size of each text string field is indicated by the ptr_t 
typedef field which contains the length of the string including the null 
character. The null character is considered part of tihe string. Once the 
strings have been calculated and the record completed, the length field 
in the audit record header is set to the size of structure plus Sie total 
lengths of the strings. This is the amount of data to write(S) to the 
audit device. 

Modifications to user passwords are audited by the password manage- 
ment subsystem. Each attempt, whether successful or not, results in an 
audit record of type RT_PASSWORD being generated. The structure 
is defined in the syslsudit.h header file: 



struct passwd_audit { 

struct audit_header aud_hdr; 

char username [ 8] ; /* login user name */ 

ushort code; /* function code */ 

}; 

The code value distinguishes between successful and unsuccessful 
attempts to change the password on the indicated user account. 

The system maintains a number of protected database files to support 
the system security policy. Attempts to modify the databases are 
audited with the RT_DATABASE type records. These records have 
the following format, as defined in <sys/audit.h>: 

struct database_activity { 

struct audit header aud hdr; 



ptr_t 


coimtand; 


/* 


conrtiand name */ 


ushort 


code; 


/* 


Type of database audit */ 


ushort 


object; 


/* 


object type */ 


long 


expected_val ; 


/* 


Expected value of parameter */ 


long 


present_val; 


/* 


Present value of parameter */ 


ptr_t 


action; 


/* 


security action that failed */ 


ptr t 


result; 


/* 


result of failure */ 



}; 

The dbase and code values identify the database and the specific 
action whether successful or not. A variable length text string area is 
provided to identify precisely what database field along with the old 
and new database field values. The audit header length field includes 
the size of the string area and the fixed portion of the record. 
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Protected subsystems use the RT SUBSYSTEM record type to record 
security related events that occur in subsystem components. Code is 
used to identify the subsystem generating the record. Both the com- 
mand and resulting action as well as the resulting failure are recorded 
in command, action and result respectively. 

struct siJbsystem_activity { 

struct audit_header aud_hdr; 
ptr_t conmand; /* command name */ 
ushort code; /* Subsystem type */ 

ptr_t action; /* action that failed */ 
ptr_t result; /* result of failure */ 

}; 

The RT_LOCK record type is used to audit user account and terminal 
locking events. The username identifies the user account which was 
locked or unlocked. Code distinguishes between the several events 
that result in the generation of a lock audit record. 

#include<sys /audit . h> 

struct lock_audit { 

struct audit_header aud_hdr; 
char username [12] ; /* login username */ 
ushort code; /* lock function code */ 

ushort trys; /* failed attempts */ 

}; 

Programs that interact with and control the audit subsystem are 
audited with the RT_AUDIT record type. The subsystem is enabled 
and disabled by an application program. The same is true of subsystem 
parameter initialization and modification. Events such as the initiation 
and termination of the audit daemon, the execution of the recovery 
mechanism, data reduction and report generation, and audit file 
archival are all audited. 

The text string portion of the audit record is only applicable for the 
audit enable function since the initial subsystem collection file must 
be specified for the daemon log file. All other audit records do not use 
this field. The code indicates which of the above events took place. 

struct audit_actions { 

struct audit_header aud_hdr; 

ushort code; /* audit function code */ 

ptr_t textl; /* initial collection file */ 

}; 

struct passwd_audit { 

struct audit_header aud_hdr; 

char username [ 8 3 ; /* login user name */ 

ushort code; /* function code */ 

}; 
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The audit device supports a number of ioctl(S) functions to control the 
audit subsystem. The format of the ioctl(S) calls is: 

iocti (fildes, command, arg) 
int fildes, command; 
struct audit_init *arg; 

-or- 

struct audit_ioctl *arg; 

-or- 

struct audit_stats *arg; 

The audit_init structure is only used for AUDIT_ENABLE command 
to perform subsystem initialization. The structure is defined as fol- 
lows: 

struct audit_init { 



uint 


buf_length; 


/* 


Ingth of data including header */ 


inask_t 


audit flags [1]; 


/* 


audit control flags */ 


itaskjt 


event itask [AUDIT MASK SIZE] ; /* system event mask */ 


uint 


read_count; 


/* 


daemon read coiant to satisfy */ 


uint 


write_count; 


/* 


write count for coll. file flush */ 


long 


write tirte; 


/* 


write flush tirte in seconds */ 


long 


switch_count ; 


/* 


collection file size maximum */ 


long 


cafjnaxsize; 


/* 


cctrpacted aiadit file max size */ 


uint 


dir_count; 


/* 


directory count */ 


uint 


uid_count; 


/* 


uid selection count */ 


uint 


gid_count; 


/* 


gid selection count */ 


ulong 


dir_offset; 


/* 


fseek of directory names */ 


ulong 


uidjoffset; 


/* 


fseek of uids to select */ 


ulong 


gid_offset; 


/* 


fseek of gids to select */ 


uint 


buff_count; 


/* 


nurrber of collection file buffers */ 


ulong 


session; 


/* 


system boot session nunber */ 


short 


audit_uid; 


/* 


audit user uid */ 


short 


audit_gid; 


/* 


audit grov;p gid */ 



}; 

The subsystem initialization parameters are established through the 
menu interface and are written to a parameter file. This file is read and 
used to fill out the above structure to initialize the subsystem. 

The event jnask is a bit mask of the selected events to audit during the 
session. Only events that are enabled will generate audit records. The 
read count value is used by the subsystem to satisfy audit daemon 
reads. Only when the specified amount of data is available in the col- 
lection file will the read be satisfied. 

The flushing of the intemal subsystem buffers to the collection file is 
controlled by the write count and write time fields. When the 
specified amount of data has accumulated, the buffers will be flushed 
to disk. A time interval in seconds can also be set which will cause the 
flushing of data to disk after a certain period of elapsed time. 

The switch count controls the size to which subsystem collection files 
may grow until a file switch is performed. The size of the output com- 
paction files written by the audit daemon are controlled by the 
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caf maxsize parameter. When these files reach this specified size, the 
daemon performs a switch to a new compaction file and records this 
fact in the audit session log file. Session is the current session value 
that is used in file name generation. The buff count value determines 
the number of file system blocksize buffers to be allocated by the sub- 
system for the purpose of internal buffering. At least 2 buffers are allo- 
cated while 4-6 is optimal. 

Dir count is the number of collection file and compaction file direc- 
tories that are available to both the subsystem and the audit daemon 
for the creation of their respective files. If a file write error occurs, 
both will attempt to use an alternate directory. Both will terminate 
only when all directories have been tried without success. The direc- 
tory names are located in the variable length directory area following 
the fixed portion of the initialization record. Each pathname is a null- 
terminated string. The dir offset field points to the start of this vari- 
able length text string area with respect to the start of the structure. 

The audit subsystem is capable of selective audit record generation 
based on user and group IDs. These values may be specified to the 
subsystem at initialization time using the uid count and gid count 
values. The actual list of user and group Ids are located at tiie end of 
the structure in a variable length table of short integers. The offsets 
where the ID arrays may be found are located by the uid offset and 
gid offset values. 

The audit uid and audit_gid fields are used to communicate certain ID 
values to the subsystem since these are used to create files with specif- 
ic owners and groups for security purposes. 

All remaining ioctl(S) commands except AUDIT_STATS use the 
audit_iocfl structure. The audit_iocti structure is defined by the fol- 
lowing: 

struct audit_ioctl { 

uint read_count; /* daeannon read count */ 

uint write_count; /* write count for file flush */ 

long writejtiire; /* write flush tine */ 

maskjt user_control [AUDIT_MASK_SI2E] ; /* control mask */ 

maskjt userjdisp [AUDIT_MASK_SIZE] ; /* disposition mask */ 

maskjt systemjTBsk [AUDIT_MASK_SIZE] ; /* system event mask */ 

}; 

The AUDIT_STATS iocti command uses the following structure for 
statistic retrieval and display. 

struct audit stats { 



uint 


session; 


/* 


current session nutttoer */ 




uint 


sequence; 


/* 


current sequence nurtber */ 




ulong 


total_bytes; 


/* 


total bytes written */ 




ulong 


total_recs; 


/* 


total records written */ 




ulong 


syscall_recs ; 


/* 


system call audit record count 


*/ 


ulong 


syscall_norecs ; 


/* 


system call audit record count 


*/ 


ulong 


aFpl_recs; 


/* 


application audit record count 


*/ 
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iilong 


read_count; 


/* 


ulong 


write_count; 


/* 


ulong 


coll_files; 


/* 


ulong 


buffersjused; 


/* 


ulong 


buffer_sleep; 


/* 



nuitiDer. of device reads */ 
nutrber of device writes */ 
nutriDer of collection files */ 
maxinutn audit buffer usage */ 
nunber of audit write sleeps */ 



The commands supported by the audit device are: 

ENABLE Initialize and enable the audit subsystem for the gen- 
eration of audit records. 



SHUTDOWN Notify the audit subsystem that a system shutdown is 
in progress. 

DISABLE Terminate the audit subsystem and close all collec- 
tion files. The audit daemon is also terminated after 
the last audit record has been read from the subsys- 
tem. 



SYSMASK Modify the audit subsystem event mask that controls 
the generation of audit records based on certain 
event types. 

USERMASK Modify the user event mask for a process. Each pro- 
cess has a mask which can be used to always or 
never audit certain event types regardless of the sys- 
tem event mask. The mask is a control mask which 
indicates for each bit set on that the generation of 
records for the corresponding event type is controlled 
by the second mask. The second mask is the 
enable/disable mask which determines whether the 
event is always or never audited. If a control mask 
bit is 0, the event is controlled by the system event 
mask. 



FLUSH Modify the write count and time interval values. 

DAEMON Modify the audit daemon read count value. 

ACK Used by the daemon to acknowledge certain events 

such as recognition of system shutdown and the disa- 
bling of the audit subsystem. Provides a synchroniza- 
tion means between the subsystem and the daemon. 

MOUNT The system has transitioned to multi-user state and 

alternate audit directories are now mounted and 
available. 



STATS Retrieve the current audit subsystem statistics from 

the audit device. 
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IDS Specify the user and group IDs to use for selective 

audit generation. 

loctl(S) calls will fail if any of the following are true: 

[EPERM] The process required SelfAudit privilege but did not 
have it. 

[EEXIST] An attempt is made to enable audit and it is already 
running. 

[EACCES] An open attempt is made on the audit device and the 
calling process does not have the configaudit or wri- 
teaudit authorization. 

[EBADF] Fildes is not a valid open file descriptor. 

[EFAULT] Arg points to an illegal address. 

[EINVAL] Command is an illegal value. 

Files 

/dev/auditr 
/dev/auditw 

See Also 

auditd(ADM), auditcmd(ADM), "Maintaining System Security," 
chapter of the System Administrator's Guide 

Diagnostics 

Upon successful completion, the device returns a 0. Otherwise, a -1 is 
returned and errno is set to indicate the error. 

Value Added 

audit is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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boot 



UNIX boot program 
Description 



boot is an interactive program used to load and execute stand-alone 
UNIX programs. It is used primarily for loading and executing the 
Altos UNIX System V kernel, but can load and execute any other pro- 
grams that are linked for stand-alone execution, boot is a required 
part of the Operating System and must be present in the root directory 
of the root filesystem to ensure successful loading of the Altos UNIX 
System V kernel. 

The boot program is invoked by the system each time the computer is 
started. To restart the system without going through lengthy shutdown 
procedures, you can use the reboot command. This causes the system 
to reboot after shutting down without waiting for keyboard input. See 
haltsys{PiDM) for more information. 

For diskette boot, the procedure has three stages: 

1. The ROMs load the boot block from sector 0 of the floppy, where 
sector 0 of the disk is the same as sector 0 of the filesystem. 

2. The boot block loads boot from the floppy filesystem. 

3. boot executes and prompts the user. 

For fixed-disk boot, the procedure has five stages: 

1. The ROMs load in the masterboot block from sector 0 on the hard 
disk. 

2. The masterboot block then loads the partition boot block (bootO) 
from sector 0 of the active partition (see ^jj^(ADM)). 

3. Then, assuming the UNIX partition is active, bootl is loaded from 
IK into the active partition. Bootl spans 20 physically contiguous 
IK blocks on the disk. 

4. bootl loads boot from the UNIX filesystem. 

5. boot executes and prompts the user. 

The fixed-disk boot procedure is invoked if the diskette drive is empty. 
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When first invoked, boot prompts for the location of a program to load 
by displaying the message: 

Altos UNIX System V/386 
Boot 



To specify the location of a program, a device and filename must be 
given. The filename must include the full pathname of the file con- 
taining the stand-alone program. You can display a list of the current 
allowable device names by typing a question mark (?). 

The format for the device and pathname is as follows: 

xx{a,byC,p,d)filename 

where: 

The a, b, c, p, and d parameters are each a number. 
The b, c, and p, parameters are optional. 

XX = device name 

('hd' for the hard disk or 'fd' for diskette device) 
filename = standard UNIX pathname. Must start with a slash 

if the program is not in the root directory. 

The meaning of parameters a and b depends upon the number 
parameters used, as described below: 

xx(a)filename 

a = minor device number of disk device. 



xx(a,b)filename 

a = minor device number of disk device. 
b = offset from start of disk. 



xx(a,b,c)filename 

a - EISA slot number of disk device 

b - SCSI channel (host adapter) number of disk device. 

c = SCSI ID number of disk device. 

In this form, the default disk partition number is 5 (the 
active partition), and the default disk division is 0 (zero). 
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xx(a,b,c)filename 

a = EISA slot number of disk device 

b = SCSI channel (host adapter) number of disk device. 

c = SCSI ID number of disk device. 

p = disk partition number 



xx(a,b,c)filename 

a = EISA slot number of disk device 

b = SCSI channel (host adapter) number of disk device. 

c = SCSI ID number of disk device. 

p = disk partition number 

d = disk division number 

All numbers are in decimal. See the manual pages for /iJ(HW) and 
/<i(HW) for minor device numbers of these devices. The location of 
the program to be loaded must always be entered first on the command 
line and be present if other boot options are specified either on the 
command line or in /etc/default/boot. Alternatively, the xx{a,b,c,p,d) 
portion of the string can be omitted altogether, and only the filename 
is used. In this form, an internal default is used for all parameters not 
specified. The specific default parameters are site-dependent. 

If you want boot to pause and wait for a RETURN before executing the 
program that it loads, enter the word "prompt" on the command line. 
For example, if you enter "prompt" and press RETURN boot prints 
the following message and waits for you to press the RETURN key 
again: 

Loaded, press <return>. 
The prompt can be changed to another string as in this example: 

prompt="change diskettes now" 

boot loads unix from the diskette, prints the message "change 
diskettes now", and waits for RETURN to be pressed. No other charac- 
ters can appear between "prompt", the "=" sign, and the prompt 
string, although string may contain spaces. When you press RETURN 
unix begins execution. "Prompt" can be set either on the command 
line or in /etc/default/boot. If a prompt is not specified, boot executes 
the loaded program without pausing. 

If you have just loaded the boot program from the distribution 
diskette, simply press <RETURN> and boot defaults to the correct 
values. 

To load from a hard disk with an ID 0 that is attached to the first chan- 
nel (0) of the board in the first slot (1), enter: 
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hd (1,0,0) Unix 

To use the default bootstring specified in /etc/default/boot, simply 
press <RETURN> when the system displays the boot prompt, and boot 
uses the values specified by DEFBOOTSTR in /etc/default/boot. 

If nothing is typed after a short while and AUTOBOOT is set to YES in 
the default root filesystem's /etc/default/boot file, boot times out and 
behaves as though a <RETURN> had been pressed, except that an 
"auto" is added to the boot string. (If, in addition to 
AUTOBOOT=YES, TIMEOUT=n is defined, boot waits n seconds 
before timing out.) boot proceeds through the boot procedure, and 
mi7(M) is passed a -a flag with no "prompt". 

If you wish to install DOS on the hard disk, it is recommended that you 
do so before you install the Operating System. See the manual page 
for dos(C). However, once you install DOS, you can boot it at the 
UNIX boot prompt by entering "dos". 

During installation, a custom masterboot is placed on the hard disk. If 
a non-standard disk is specified, its parameters are stored and enabled 
in this masterboot. 

Configuring the Kernel 



boot passes portions of the bootstring typed at the boot prompt to the 
kernel. 

The kernel reads the bootstring to determine which peripherals are the 
root, pipe, and swap devices. If no devices are specified in either the 
/etc/default/boot description or on the command line, the default de- 
vices compiled into the kemel are used. 

Additional arguments in the bootstring can alter this default action. 
These arguments have the form: 

dev=xx(a,b) 

where: 

dev = the desired system device (e.g., root, pipe, 
or swap) 

XX = the desired boot device (e.g., hd or fd) 



If only the a parameter is used, in this form: 

dev=xx(a) 

then: 

a = minor device number 
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If the (a,b) pair is used, as in this form: 

dev=xx(a,b) 

then: 

a = major device number 
b = minor device number 

If any combination of root, pipe, or swap is specified, then those sys- 
tem devices will reside on that device, with the unspecified system de- 
vices using the defaults compiled in the kernel. Setting one device 
does not affect the default values for the other system devices. 

Selecting the System Console 



You can select the system console at boot time either by entering the 
command systty=jc at the boot prompt, or by placing the keyword 
SYSTTY=;[: in the file /ete/default/boot. The letter x represents either 
a number or a string parameter. 

If you use the systty=jc command at boot time, boot uses the string 
parameter x to pass the selected console device to the kernel. The 
values of the bootstring parameter systty are: 

sip Serial port COM 1 
cn Display adapter 

For example, to assign the system console to the serial port at COMl, 
enter this command at the boot prompt: 

systtY=sio 

If you do not specifically set the system console at boot time, the boot 
program follows these steps to determine the system console: 

- boot reads /etc/default/boot and looks for the keyword 
SYSTTY=jc, where x is a number that specifies the system console 
device. 

1 indicates the serial adapter at COMl 
0 indicates the display adapter 

- If SYSTTY is not found or /etc/default/boot is unreadable, boot 
checks for a display adapter and assigns it as the system console. 

- If no display adapter is found, boot looks for COMl, sets the serial 
port to 9600 baud, 8 data bits, 1 stop bit, and no parity, and uses it 
as the system console. 
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Thus, to have boot automatically set the system console to the serial 
port at COMl, enter this line in /etc/default/boot: 

SYSTTY=1 

Aliasing 



A set of system devices can be aliased to a single keyword by defining 
the keyword in the file /etc/default/boot. This keyword can then be 
entered on the "Boot" command line and the boot program then reads 
the corresponding system devices from /etc/default/boot and pass 
them to the kernel. An alias has the following form: 

key=file [root=xc(a,fe,c^,d) pipe=xx(aj}) swap=xc(a,Z>) pmmpt[="string"]] 

The following is an example alias string that can be added to the 
/etc/default/boot file: 

harddisk=hd(l,0,0)unix root=hd(40) pipe=hd(40) swap=hd(41) 

The next time you boot the system, enter harddisk in response to the 
"Boot:" prompt. The effect will be equivalent to having typed the 
string that harddisk is aliased to. 

Other Command Line Parameters 



Several other command line parameters are recognized by boot, as 
summarized below: 

verbose=no 
verbose=yes 

Whether or not to display initialization messages during system 
boot. The default action is specified in the file /etc/default/boot, 
but the actual mode can be modified on the command line. See the 
"Boot Options" section below. 

restart=no 
restart=yes 

Whether to attempt a UPS shutsave restart operation when a valid 
saved restart image exists on the restart disk device. The default 
action is specified in the file /etc/default/boot, but the actual mode 
can be modified on the command line. See the "Boot Options" 
section below. 
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Boot options can be changed via keywords in /etc/default/boot. The 
following keywords are recognized by boot: 

AUTOBOOT=YES If YES, boot automatically loads 

Altos UNIX System V after a delay time 
specified by the TIMEOUT parameter. The 
default value is 30 seconds. 



DEFBOOTSTR=string 



string is used as the default bootstring for 
timeouts or when only a <RETURN> is 
entered at the boot prompt. There can be no 
white space between DEFBOOTSTR, the 
sign and string. 



SYSTTY=jc 



If X is 1, the system console device is set to 
the serial adapter at COMl. If jc is 0 the sys- 
tem console is set to the main display 
adapter. 



RONLYROOT=NO 



Whether or not the root filesystem is to be 
mounted readonly. This should only be set 
to YES during installation. 



FSCKFIX=YES or NO Whether or notfsck(ADM) fixes any root 

system problems by itself. If the variable is 
set to YES, then fsck is run on the root 
filesystem with the -rr flag. 

MULTIUSER=YES or NO Whether or not init(M) invokes sulogin or 

proceeds to multiuser mode. 



PANICBOOT=YES or NO Whether or not the system reboots after a 

panic(). This variable is read from 
/etc/default/boot by init. 

TIMEOUT=n n is the number of seconds to wait at the 

boot prompt before timing out and booting 
the kemel (if AUTOBOOT is set to YES). 



VERBOSE=YES or NO Whether or not to display initialization mes- 
sages during boot. Default is NO, which 
causes kemel messages to be logged in 
/usr/adm/messages, and startup script mes- 
sages to be loggai in /etc/rclog. 
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RESTART=YES or NO Whether to attempt a UPS shutsave restart 

operation (see upsconfig(ADM)). If set to 
YES, a restart will always happen after a 
shutsave operation had brought the system 
down. If set to NO, the system will always 
perform a normal bootstrap. 

RSPART=xx(a,b,c,p,d) Specifies the shutsave restart disk device. 

TTie convention used for xx and a, b, c, p, 
and d are identical to the boot device 
description, except there is no filename. 
See upsconfigiADM). 

The following special boot options are for intended for use applica- 
tions with a special need to alter init's tolerance for processes that 
need to be restarted. 

SPAWNJNTERVAL 

The number of seconds over which "init" will try to 
respawn a process SPAWN_LIMIT times before it gets 
mad. The default value is 120. 

SPAWN_LIMIT 

The number of respawns "init" will attempt in 
SPANWJNTERVAL seconds it generates an error mes- 
sage and inhibits further tries for INHIBIT seconds. The 
default value is 10. 

SLEEPTIME 

Sets the time (in seconds) between calls to sync. 

INHIBIT 

The number of seconds "init" ignores an entry it had trou- 
ble spawning unless a "telinit Q" is received. The default 
value is 300. 

Diagnostics 



If an error occurs, masterboot displays an error message, and locks the 
system. The following is a list of the most common messages and 
their meanings: 

10 ERR An error occurred when masterboot tried to read in the 
partition boot of the active operating system. 

BAD TBL The bootable partition indicator of at least one of the op- 
erating systems in the fdisk table contains an unrecogniz- 
able code. 
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NO OS There was an unrecoverable error that prevented the 
active operating system's partition boot from executing. 



When boot displays error messages, it returns to the "Boot" prompt. 
The following is a list of the most common messages and their mean- 
ings: 

bad magic number 

The given file is not an executable program. 

can't open <pathname> 

The supplied pathname does not correspond to an existing file, or 
the device is unknown. 

Stage 1 boot failure 

The bootstrap loader cannot find or read the boot file. You must 
restart the computer and supply a filesystem disk with the boot file 
in the root directory. 

not a directory 

The specified area on the device does not contain a valid UNIX 
filesystem. 

zero length directory 

Although an otherwise valid filesystem was found, it contains a 
directory of apparently zero length. This most often occurs when a 
pre- System V UNIX filesystem (with incorrect, or incompatible 
word ordering) is in the specified area. 

fload:read(jc)=y 

An attempted read of x bytes of the file returned only y bytes. This 
is probably due to a premature end-of-file. It could also be caused 
by a corrupted file, or incorrect word ordering in the header. 

Files 



/boot 

/etc/default/boot 
/etc/masterboot 
/etc/hdbootO 
/etc/hdbootl 

See Also 



autoboot(ADM), badtrk(ADM), fd(HW), fdisk(ADM), fsck(ADM), 
haltsys(ADM), hd(HW), init(M), sulogin(ADM), upsconfig(ADM) 
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The computer tries to boot off any diskette in the drive. If the diskette 
does not contain a valid bootstrap program, errors occur. The boot 
program can be used to load other standalone programs besides the 
UNIX kernel, but these standalone programs must be in COFF binary 
format. (See a.out(P).) Moreover, these programs must be linked for 
standalone execution. 

RONLYROOT should only be set to YES for installation. If it is set to 
YES during day-to-day operations, it will prevent your making 
changes to the root filesystem. You will then be required to boot from 
the floppy drive, edit the /etc/default/boot file, and reboot. 

Value Added 



boot is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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compact disk devices 
Description 



The cdrom devices implement the interface with compact disk drives. 

The character special cd devices (/dev/rcdO, and so forth) support raw 
I/O in multiples of the physical sector size of the CD-ROM (typically 
2048 bytes). 

The block special cd devices (/dev/cdO and so forth) support buffered 
I/O. 

The minor device number determines which compact disk unit will be 
accessed. The correspondence beween the unit number and the SCSI 
host adaptor, controller and lun is defined in the SCSI configuration 
file /etc/conf/cf.d/mscsi. 

Flies 



/dev/cd[0-n] 

/dev/rcd[0-n] 

/usr/lib/mkdev/cdrom 

See Aiso 



scsi(HW), mkdev(ADM) 

Notes 



Because the CD-ROM is a read-only device it is only possible to open 
it for input. 

The command mkdev cdrom can be used to interactively configure the 
CD-ROM driver. 
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cmos 



displays and sets the configuration data base 
Syntax 



cmos [ address [ value ] ] 

Description 



The cmos command displays and/or sets the values in the CMOS con- 
figuration data base. This battery-powered data base stores configura- 
tion information about the computer that is used at power up to define 
the system hardware configuration and to direct boot procedures. The 
data base is 64 bytes long and is reserved for system operation. Refer 
to your computer hardware manual for more information. 

The cmos command is typically used to alter the current hardware 
configuration when new devices are added to the system. When only 
address is given, the command displays the value at that address. If 
both address and a value are given, the command assigns the value to 
that address. If no arguments are given, the command displays the 
entire contents of the data base. 

The CMOS configuration data base may also be examined and modi- 
fied by reading from and writing to /dev/cmos file. Because success- 
ful system operation depends on correct configuration information, the 
data base should be modified by experienced system administrators 
only. 

The diagnostic diskette should be run before setting the CMOS data 
base. 

Note that this section refers to the standard AT CMOS, not the EISA 
nonvolatile memory, which is maintained through the EISA Configura- 
tion Utility. 

Files 



/etc/cmos 
/dev/cmos 
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fd 



floppy devices 
Description 



The fd devices implement the interface with floppy disk drives. Each 
device name corresponds to a specific major and minor device. Typi- 
cally, the tar(C), cpio(C) or dd(C) commands are used to read or write 
floppy disks. For instance, 

tartvf/dev/fdO 

tabulates the contents of the floppy disk in drive 0 (zero). 

The block special fd devices are also block-buffered. The floppy 
driver can read or write IK bytes at a time using raw i/o. Note that 
block transfers are always a multiple of the IK disk block size. 

XENIX Devices 



XENIX diskette device file names use the following format: 

/dev/[r]fd[0,l][48ss8,48ss9,96ds9,96dsl5,135ds9,135dsl8] 

(See Notes, below, for more information about device naming pro- 
cedure.) The corresponding character special (raw) devices afford 
direct, unbuffered transmission between the floppy and the user's read 
or write transfer address in the user's program. 

For information about formatting, see format (C), 

The minor device number determines what kind of physical device is 
attached to each device file (see Notes). When accessing the charac- 
ter special floppy devices, the user's buffer must begin on a word 
boundary. The count in a read(S), write (S), or lseek(S)cal\ to a char- 
acter special floppy device must be a multiple of IK bytes. 

Device names determine the particular drive and media configuration. 
The device names have the form: 

fd048ds9 

Where: 
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fdO = drive number (0, 1, 2 or 3) 
48 = number of disk tracks per inch (48 or 96) 
ds = single or double sided floppy (ss or ds) 
9 = number of sectors on the floppy (8 or 9) 

For instance, /dev/fd048ss9 indicates a 48 track per inch, single sided, 
9 sector floppy disk device in drive 0. 

The minor device numbers for floppy drives depend on the drive and 
media configuration. The most common are: 







48tpi 






96tpi 


135tpi 




ds/8 


ds/9 


ss/8 


ss/9 


ds/15 


ds/8 


ds/9 


ds/18 


Drive 


Minor Device Number 


0 


12 


4 


8 


0 


52 


44 


36 


60 


1 


13 


5 


9 


1 


53 


45 


37 


61 


2 


14 


6 


10 


2 


54 


46 


38 


62 


3* 



















* reserved for special, non-floppy devices connected to the floppy 
controller as unit #3, 



The scheme for creating minor device numbers is as follows. When 
interpreted as a binary number, each bit of the minor device number 
represents some aspect of the device/media configuration. 

For example, the minor device number for /dev/fd048ss8 is "8." 
Interpreted as a binary number, 8 is: 

00001000 

This is how each bit, or binary digit, is significant: 



48tpi - 0 


Sectors per 
Track 


ss - 0 


Drive 


96tpi - 1 
135tpi - 1 


ds - 1 


32 


16 8 


4 


2 1 


0 


0 1 


0 


0 0 
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Only the last six digits of the number are used in minor device 
identification. The fijst significant digit is the third from the left. In 
this example, the third digit from the left is zero, thus the device is 
48tpi. The next two digits mean: 



Bil 


ts 


Sectors per 
Track 


16 


8 


0 
0 
1 

1 


0 
1 
0 
1 


9 
8 
15 
18 



The fourth digit tells whether the floppy is single sided (ss - 0) or dou- 
ble sided (ds - 1). The last two signify the drive number: 



Bits 


Drive 
Number 


2 


1 


0 


0 


0 


0 


1 


1 


1 


0 


2 


1 


1 


3* 



* reserved for special, non-floppy devices connected to the floppy 
controller as unit #3. 

Using this information, you can construct any minor device numbers 
you need. 

UNIX Devices 



UNIX diskette device file names use the following format: 

/dev/[r]dsk/f[0,l][5h,5d9,5d8,5d4,5dl6,5q,3h53d][t,u] 

where r indicates a raw (character) interface to the diskette, rdsk 
selects the raw device interface and dsk selects the block device inter- 
face. 0 or 1 selects the drive to be accessed: fO selects floppy drive 0, 
while fl selects drive 1 . The following list describes the format to be 
interacted with: 

5h 5.25" high density diskette (1 .2MB). 
5d9 5.25" double density diskette, 9 sectors per track 
(360KB). 

5d8 5.25" double density diskette, 8 sectors per track 
(320KB). 
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5d4 5.25" double density diskette, 4 sectors per track 
(320KB). 

5dl6 5.25" double density diskette, 16 sectors per track 
(320KB). 

5q 5.25" quad density diskette (720KB). 
3h 3.50" high density diskette (1 .44MB). 
3d 3.50" double density diskette (720KB). 



Format specification is mandatory when opening the device for for- 
matting. However, when accessing a floppy disk for other operations 
(read and write), the format specification field can be omitted. In this 
case, the floppy disk driver will automatically determine the format 
previously established on the diskette and then perform the requested 
operation (for example, epic -itv</dev/rdsk/fl). 

The last parameter, t or u, selects the partition to be accessed, t 
represents the whole diskette. Without t or u specified, the whole 
diskette except cylinder 0 will be selected, u represents the whole 
diskette except track 0 of cylinder 0. 

Besides the device file naming convention described above, some of 
the formats have alias names that correlate to previous releases. The 
following list describes the formats that have an alias: 



format alias 

5h ql5d 

5d8 d8d 

5d9 d9d 



For example, the device file /dev/rdsk/f0ql5dt is equivalent to 
/dev/rdsk/f05ht. 



Files 



XENIX Devices: 



/dev/[r]fdO 

/dev/[r]fdl 

/dev/[r]fd048 

/dev/[r]fdl48 

/dev/[r]fd048ds8 

/dev/[r]fdl48ds8 



/dev/[r]fd048ss8 
/dev/[r]fdl48ss8 
/dev/[r]fd048ds9 
/dev/[r]fdl48ds9 
/dev/[r]fd048ss9 
/dev/[r]fdl48ss9 



/dev/[r]fd096 

/dev/[r]fdl96 

/dev/[r]fd096ds9 

/dev/[r]fdl96ds9 

/dev/[r]fd096dsl5 

/dev/[r]fdl96dsl5 



/dev/[r]fd0135ds9 
/dev/[r]fdll35ds9 
/dev/[r]fd0135dsl8 
/dev/[r]fdll35dsl8 
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UNIX Devices: 

/dev/[r]dsk/fO /(Iev/[r]dsk/f05d9t /dev/[r]dsk/f05dl6 /dev/[r]dsk/«)3ht 

/dev/[r]dsk/fOt /dev/[r]dsk/ft)fd8 /dev/[r]dsk/f05dl6t /dev/[r]dsk/fi)3d 

/dev/[r]dsk/fl)5h /dev/[r]dsk/f05d8t /dev/[r]dsk/fl)5q /dev/[r]dsk/ft)3dt 

/dev/[r]dsk/fl)5ht /dev/[r]dsk/f05d4 /dev/[r]dsk/f05qt 

/dev/[r]dsk/fl)5d9 /dev/[r]dsk/f05d4t /dev/[r]dsk/fl)3h 



Notes 



It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi or 135tpi) floppy drive. Low density diskettes written 
on a high density drive should be read on high density drives. They 
may or may not be readable on a low density drive. 

Use error-free floppy disks for best results on reading and writing. 
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hd 



internal hard disk drive 
Description 



Device Filenames 

There are two formats for the device filename describing a hard disk 
is, the first (hddpv) is based on XENIX, and is the preferred form. The 
second example is the equivalent UNIX form: 

/de\/[r]Mdpv 

/de\/[r]dsk/dsp 

where: 

[r] raw (character) special file or (or directory containing such files). 
If not present, this file is a block special file. 

d disk "number" (actually a letter) ranging from a to z, and A to Z. 
The disk number is based on the order in which the disk was added 
to the system, not its physical location. 

p fdisk partition number, from 1 to a maximum of 4. Partition num- 
ber 0 equals all partitions (the entire disk). The active partition is 
partition a. A DOS partition is partition d. (An active UNIX parti- 
ton is also partition 5; an active DOS parition, partition 6. The use 
of these partition numbers is discouraged. Use the equivalent 
letters described above.) 

V is the divvy division number, numbered 0 to 6. Division number 7 
equals all divisions (the entire partition). 

See divv>'(ADM) for details on divisions, and fdisk(ADM) for details 
on partitions. 

Block-buffered access to the first hard disk is provided through the fol- 
lowing block special files: hdaO, hdal through hda4, hdaa and hdad, 
root, and swap. Block-buffered access to the second hard disk is pro- 
vided through the following block special files: hdbO, hdbl through 
hdb4, hdba. 

hdaO refers to the entire physical disk; hdal through hda4 refer to the 
fdisk partitions, root refers to the root file system; swap refers to the 
swap area; The block special files access the disks via the system's 
normal buffering mechanism and may be read and written without 



March 19, 1991 



HD-1 



HD(HW) 



HD (HW) 



regard to the size of physical disk records. 



Note 

These disk names (and all other references to multiple hard disk 
configurations) are based on the the chronological sequence of disk 
additions, not necessarily the the physical order. Thus, when we 
indicate that hdaO refers to the "first" hard disk, this means the 
disk was the first disk added to the system. The name hdbO refers to 
the "second" disk added to the system, which could possibly be 
located above the "first" disk. See the System Administrator's 
Guide for more information on hard disk naming conventions. 



Character special files follow the same naming convention as the 
block special files except that the character special file is prefaced 
with an "r". For example, the character special file referring to the 
entire physical disk is /dev/rhdaO. 

The following are the names of the fixed disk partitions. Each parti- 
tion can be accessed through a block interface, for example 
/dev/hdal, or through a character (raw) interface, for example 
/dev/rhdal. 

The devices described above follow the XENIX naming convention. 
Equivalant UNIX devices are found in the /dev/dsk (character) and 
/dev/rdsk (raw) directories. In the table that follows, equivalent 
XENIX and UNIX device names are shown for various possible parti- 
tions of a hard disk. 
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Device Filenames for Hard Disks 


XENIX Naming 
Disk 1 Disk 2 


UNIX Naming 
Disk 1 Disk 2 


Partition 


/dev/hdaO /dev/hdbO 
/dev/riidaO /dev/rtidbO 


/dev/dsk/asO /dev/dskA)sO 
/dev/rdsk/asO /dev/rdsk/bsO 


entire disk 


/dev/hdal /dev/hdbl 
/dev/rhdal /dev/rhdbl 


/dev/dsk/asl /dev/dsk/bsl 
/dev/rdsk/asl /dev/rdsk/bsl 


first partition 


/dev/hda2 /dev/hdb2 
/dev/rhda2 /dev/riidb2 


/dev/dsk/as2 /dev/dsk/bs2 
/dev/rdsk/as2 /dev/rdsk/bs2 


second partition 


/dev/hda3 /dev/hdb3 
/dev/riida3 /dev/itidb3 


/dev/dsk/as3 /dev/dsk/bs3 
/dev/rdsk/as3 /dev/rdsk/bs3 


third partition 


/dev/hda4 /dev/hdb4 
/dev/rtida4 /dev/itidb4 


/dev/dsk/as4 /dev/dsk/bs4 
/dev/rdsk/as4 /dev/rdskA>s4 


fourth partition 


/dev/hdaa /dev/hdba 
/dev/ihdaa /dev/iiidba 


/dev/dsk/asa /dev/dskybsa 
/dev/rdsk/asa /dev/rdsk/bsa 


active partition 


/dev/hdad /dev/hdbd 
/dev/ilidad /dev/ihdbd 


/dev/dsk/asd /dev/dsk/bsd 
/dev/rdsk/asd /dev/rdsk/bsd 


DOS partition 


/dev/root 
/dev/rroot 




root file system 


/dev/swap 
/dev/rswap 




swap area 


/dev/usr 
/dev/rusr 




user filesystem 



Note that the root, swap, and usr device names exist only for the root 
disk. Also recall that the names of these disks (i.e., hdaO or asO) are 
based on the assumption that "Disk 1" was the first disk installed in 
the system, and that "Disk 2" was installed second. 

To access DOS partitions, specify letters such as "C:" or "D:" to 
indicate first or second partitions. The file /etc/default/msdos con- 
tains lines that assign a letter abbreviation for the DOS device name. 
Refer to dos(C). 

Major/Minor Device Numbers 

The operating system reserves 16 major device numbers, 64 through 
79, in the kernel for use with hard disks. Since only 52 hard disks are 
currently supported, only major numbers 64 through 76 can be used. 
The remaining major numbers (77 through 79) are still reserved by the 
kernel, and are unavailable for use at this time. 

Refer to the description of diwy (ADM) for a table that shows the rela- 
tionship of disks (identified by their logical SCSI index) to major num- 
bers and host adapter/board combinations. 

The lower four bits of the major device number and bits 7 and 6 of the 
minor device number also indicate the logical SCSI index. 
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The following table lists the minor device number definitions for the 
hard disk special files, along with examples. Note that the block and 
character special devices share the same minor device definition. The 
minor device number definition is as follows: bits 7 and 6 denote phy- 
sical drive, bits 5-3 denote fdisk partition and bits 2-0 denote diwy 
partition. 

The special device filenames for the two disks in the following table 
are possible names used only as a likely example. Recall that the disk 
device filename is not dictated by major/minor number, or by physical 
location in the computer system. Disk device filenames follow the 
sequence in which they are added to the system. 
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Minor Device Bits 


Phys. 


Partition 


divvy 


Device special 


Description 


7 6 


5 


4 3 


2 1 


0 


filename 




0 0 


0 


0 


0 


0 0 


0 


/dev/hdaO 


whole PD 0 


0 1 


0 


0 


0 


0 0 


0 


/dev/hdbO 


whole PD 1 


1 0 


0 


0 


0 


0 0 


0 


/dev/hdcO 


whole PD 2 


1 1 


0 


0 


0 


0 0 


0 


/dev/hddO 


whole PD 3 


0 0 


0 


0 


1 


1 1 


1 


/dev/hdal 


PD 0, whole Part. 1 


0 0 


0 


1 


0 


1 1 


1 


/dev/hda2 


PD 0, whole Part. 2 


0 0 


0 


1 


1 


1 1 


1 


/dev/hda3 


PD 0, whole Part. 3 


0 0 


1 


0 


0 


1 1 


1 


/dev/hda4 


PD 0, whole Part. 4 


0 0 


1 


0 


1 


1 1 


1 


/dev/hdaa 


PD 0, whole active Part. 


0 0 


1 


1 


0 


1 1 


1 


/dev/hdad 


PD 0, whole DOS Part. 


0 0 


1 


0 


1 


0 0 




/devA-oot 


PD 0, active Part., Div. 0 


0 0 


1 


0 


1 


0 0 


1 


/dev/swap 


PD 0, active Part., Div. 1 


0 0 


1 


0 


1 


0 1 




/dev/usr 


PD 0, active Part., Div. 2 


0 0 


1 


0 


1 


1 1 




/dev/recover 


PD 0, active Part., Div. 6 


0 1 


0 


0 


1 


1 1 




/dev/hdbl 


PD 1, whole Part. 1 


0 1 


0 


1 


0 


1 1 


1 


/dev/hdb2 


PD 1, whole Part. 2 


0 1 


0 


1 


1 


1 1 


1 


/dev/hdb3 


PD 1, whole Part. 3 


0 1 


1 


0 


0 


1 1 


1 


/dev/hdb4 


PD 1, whole Part. 4 


0 1 


1 


0 


1 


1 1 


1 


/dev/hdba 


PD 1, whole active Part. 


0 1 


1 


1 


0 


1 1 


1 


/dev/hdbd 


PD 1, whole DOS Part. 


0 1 


0 


0 


1 


0 0 




/dev/hdblO 


PD l.Part. l,Div. 0 


0 1 


0 


0 


1 


0 0 


1 


/dev/hdbll 


PD l,Part. l,Div. 1 


0 1 


0 


0 


1 


0 1 




/dev/hdbl 2 


PD l,Part. l,Div. 2 


1 1 


0 


0 


1 


1 1 


1 


/dev/hdcl 


PD 2, whole Part. 1 


1 1 


0 


1 


0 


} } 


} 


/dev/hdc2 


PD 2, whole Part. 2 


1 1 


0 


1 


1 






/dev/hdc3 


PD 2, whole Part. 3 


1 1 


1 


0 


0 




1 


/dev/hdc4 


PD 2, whole Part. 4 


1 1 


1 


0 


1 






/dev/hdca 


PD 2, whole active Part. 


I I 


1 


1 


0 






/dev/hdcd 


PD 2, whole DOS Part. 


1 1 


0 


0 


1 






/dev/hddl 


PD 3, whole Part. 1 


1 1 


0 


1 


0 






/dev/hdd2 


PD 3, whole Part. 2 


1 1 


0 


1 


1 






/dev/hdd3 


PD 3, whole Part. 3 


1 1 


1 


0 


0 






/dev/hdd4 


PD 3, whole Part. 4 


1 1 


1 


0 


1 






/dev/hdda 


PD 3, whole active Part. 


1 1 


1 


1 


0 






/dev/hddd 


PD 3, whole DOS Part. 


KEY 


Part. 


= Partition 




PD = physical drive (in order added, not location) 



Div. = Division 



See Also 



fdisk(ADM), badti-k(ADM), divvy(ADM), dos(C), mkdev(ADM), the 
System Administrator's Guide 
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The following messages are among those that may be printed on the 
console: 

invalid fixed disk parameter table 
and: 

error on fixed disk (minor n), block = nnnnn, 

cmd=«nnnn, status=nn/in, 

Sector = nnnnn. Cylinder/head = nnnnn 

Possible reasons for ±e first error include: 

- The kernel is unable to get drive specifications, such as number of 
heads, cylinders, and sectors per track, from the disk controller 
ROM. 

- Improper configuration. 

- The disk is not turned on. 

- The disk is not supported. 

The second error specifies the following information: 

- block : The UNDC block number within the device. 

- cmd : The last command sent to the disk controller. 
status : The error status from the disk controller. 

- Sector and Cylinder/ head specify the location of a possible flaw. 
This information is used with badtrk(ADM). (Applicable only 
with non-SCSI hard disks.) 

Notes 



On the first disk, hdaO denotes the entire disk and is used to access the 
master boot block which includes the fdisk partition table. For the 
second disk, hdbO denotes the entire disk and is used to access its 
fdisk partition table. Do not write to hdbO and hdaO. 

You can mount a filesystem only by referring to it by its full device 
filename (that must inlcude a divvy specification). For example, use 
/dev/hdblO to mount a filesystem that starts at division 0 of the active 
partiton (1) on the second hard disk (b). The device filename 
/dev/hdbO, to indicate all partitions (0) of the second disk (b), will not 
work! 
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keyboard 



the PC keyboard 
Description 



The PC keyboard is used to enter data, switch screens, and send cer- 
tain control signals to the computer. The Operating System performs 
terminal emulation on the PC screen and keyboard, and, in doing so, 
makes use of several particular keys and key combinations. These 
keys and key combinations have special names that are unique to 
UNIX systems, and may or may not correspond to the keytop labels on 
your keyboard. These keys are described later. 

When you press a key, one of the following happens: 

- An ASCII value is entered 

- A string is sent to the computer. 

- A function is initiated. 

- The meaning of another key, or keys, is changed. 

When a key is pressed (a keystroke), the keyboard sends a scancode to 
the computer, it is interpreted by the keyboard driver. The interpreta- 
tion of key codes may be modified so that keys can function dif- 
ferently from their default actions. 

There are three special occurrences, or keystrokes: 

- Switch screens. 

- Send signals. 

- Change the value of previous character, characters or string. 



Switcliing Screens (l\/lultiscreen) 



To get to the next consecutive screen, enter Ctrl-PrtSc using the Ctrl 
key, and the PrtSc key. Any active screen may be selected by enter- 
ing alt-Fn, where Fn is one of the function keys. Fl refers to the PC 
display (/dev/ttyOl). 
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A signal affects some process or processes. Examples of signals are 
Ctrl-d (end of input, exits from shell), CtrlA (quits a process), Ctrl-s 
(stop output to the screen), and Ctrl-q (resume sending output). 

Typically, characters are mapped to signals using stty(C). The only 
way to map signals is using stty. 

Altering Vaiues 



The actual code sent to the keyboard driver can be changed by using 
certain keys in combination. For example, the SHIFT key changes the 
ASCII values of the alphanumeric keys. Holding down the Ctrl key 
while pressing another key sends a control code (Ctrl-d, Ctrl-s, 
Ctrl-q, etc.). 

Speciai Keys 



To help you find the special keys, the following table shows which 
keys on a typical console correspond to UNIX system keys. In this 
table, a hyphen (-) between keys means *hold down the first key while 
pressing the second.' 

UNIX Name Keytop Action 

INTR Del Stops current action and returns 



to the shell. This key is also 
called the RUB OUT or INTER- 
RUPT key. 



BACKSPACE 



<— 



Deletes the first character to 
the left of the cursor. 



Note that the "cursor left" key 
also has a left arrow (<— ) on its 
keytop, but you cannot back- 
space using that key. 



Ctrl-d 



Ctrl-d 



Signals the end of input from 
the keyboard; also exits current 
shell. 



Ctrl-h 



Ctrl-h 



Deletes the first character to 
the left of the cursor. Also 
called the ERASE key. 



Ctrl-q 



Ctrl-q 



Restarts printing after it has 
been stopped with Ctrl-s. 
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UNIX Name Keytop 

Ctrl-s Ctrl-s 

Ctrl-u Ctrl-u 
CtrlA CtrlA 

ESCAPE Esc 

RETURN (down-left arrow 

or ENTER) 

Fn Fn 



KEYBOARD (HW) 

Action 

Suspends printing on the screen 
(does not stop the program). 

Deletes all characters on the 
current line. Also called the 
KILL key. 

Quits current command and 
creates a core file, if allowed. 
(Recommended for debugging 
only.) 

Special code for some pro- 
grams. For example, changes 
from insert mode to command 
mode in the v/(C) text editor. 

Terminates a command line and 
initiates an action from the 
shell. 

Function key n. F1-F12 are 
unshifted, F13-F24 are shifted 
F1-F12, F25-F36 are Ctrl-Fl 
through F12, and F37-F48 are 
Ctrl-Shift-Fl through F12. 

The next Fn keys (F49-F60) are 
on the number pad (unshifted): 



F49 - 


'7' 


F55 - 


'6' 


F50 - 


'8' 


F56 - 


'+' 


F51 - 


'9' 


F57 - 


T 


F52 - 




F58 - 


'2' 


F53 - 


'4' 


F59 - 


'3' 


F54 - 


'5' 


F60 - 


'0' 



For keys F61 through F96, see 
/usr/lib/keyboard/ strings. 
These function keys are not 
available on all keyboards, but 
you can map other keys to 
represent them. 



The keyboard mapping is performed through a structure defined in 
/usr/include/sys/keyboard.h. Each key can have ten states. The first 
eight are: 



- Base - Ctrl-Shift 

- Shift - Alt-Shift 

- Ctrl - Alt-Ctrl 

- Alt - Alt-Ctrl-Shift 
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There are two additional states indicated by two special bytes. The 
first is a "special state" byte whose bits indicate whether the key is 
"special' ' in one or more of the first eight states. 

The second is one of four characters (C, N, B, O) which indicate how 
the lock keys affect the particular key. This is discussed further in the 
next section, "Scan Codes." 

Keyboard Mode 



Most keyboards normally are in a PC compatibility mode, though 
some can be put into a native AT keyboard mode. The UNIX utility 
kbmode(ADM) can be used to determine if a keyboard supports AT 
mode, and can also be used to put the keyboard into AT mode until the 
next time the system is rebooted. A system can also be configured to 
boot with the keyboard in AT mode with the configure(ADM) utility. 

Enhanced keyboards are more fully programmable in AT mode. Also, 
it recognizes two control keys and an alt key. 

Scan Codes 



The following table describes the default contents of 
/usr/lib/keyboard/keys. The column headings are: 

SCAN CODE - The scan code generated by the keyboard hardware 
when a key is pressed. There is no user access to the scan code gen- 
erated by releasing a key. 

BASE - The normal value of a key press. 

SHIFT - The value of a key press when the SHIFT is also being held 
down. 

LOCK - Indicates which lock keys affect that particular key: 

- C indicates Capslock 

- N indicates Numlock 

- B indicates both 

- O indicates locking is off 

Keys affected by the lock keys C, B, or N, send the shifted value (scan 
code) of current state when that lock key is on. When the shift key is 
depressed while a lock key is also on, the key reverts (toggles) to its 
original state. 

The other columns are the values of key presses when combinations of 
the CTRL, ALT and SHIFT keys are also held down. 
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All values, except for keywords, are ASCII character values. The key- 
words refer to the special function keys. 



SCAN 
CODE 


BASE 


SHIFT 


CTRL 


CTRL 
SHIFT 


ALT 


ALT 
SHIFr 


ALT 
CTRL 


ALT 
CTRL 
SHIFT 


L 


n 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


yj 


1 
1 


6SC 


6SC 


nop 


nop 


esc 


esc 


nop 


nop 


n 
\J 


z 


'1 ' 
1 


M ' 


nop 


nop 




»( » 


nop 


nop 


n 
yj 


•3 
J 


z 




nop 


nop 


z 


(gj 


nop 


nop 


r\ 

KJ 


A 
H 




'U' 
TT 


nop 


nop 


"3' 

D 


TT 


nop 


nop 


KJ 


e 

J 




* 


nop 


nop 


4 




nop 


nop 


f\ 
\j 


6 


'5' 


'%' 


nop 


nop 


'5' 


'%' 


nop 


nop 


0 


/ 


0 




rs 


rs 


0 




rs 


rs 


u 


Q 

0 


/ 




nop 


nop 


'7' 


oc 


nop 


nop 


U 


Q 


>o» 
0 




nop 


nop 


»o • 
0 


* 


nop 


nop 


u 


1 n 

IK) 


»Q» 


(. 


nop 


nop 


'Q' 

y 


( 


nop 


nop 


U 


11 


'0' 


')' 


nop 


nop 


'0' 


')' 


nop 


nop 


0 


12 






ns 


ns 




'-' 


ns 


ns 


0 






'+' 


nop 


nop 




'+' 


nop 


nop 


0 


1 A 

14 


DS 


bs 


del 


del 


bs 


bs 


del 


del 


0 


15 


nt 


DtaD 


nop 


nop 


ht 


btab 


nop 


nop 


0 


lo 


'q' 


Q 


del 


del 


'q' 


'Q' 


del 


del 


c 


1 1 
I 1 


w' 


W 


eto 


etb 


'w' 


W 


etb 


etb 




10 


'e' 


'E' 


enq 


enq 


'e' 


'E' 


enq 


enq 


L. 


1Q 


r. 


Jx 


ucz 


ucz 


r 




ucz 


ucz 


P 


ZD 


t' 


1 


ac4 


ac4 


't' 


1 


Af^A 

ac4 


Af%A 

(iC4 




0 1 


'y' 


•V' 
I 


em 


em 


'y' 


' v 
I 


em 


em 




ZZ 


'u' 


U 


nak 


nak 


'u' 


U 


nak 


nak 


L. 


O'J 

Zd 


1 


1 


nt 


nt 


'i' 


1 


nt 


nt 




OA 
Zf 


0 


u 


si 


si 


'o' 




si 


si 


/-< 


Zj 


'p' 


»T>> 

r 


uie 


uie 


'P' 


»¥>» 

r 


Ala 

Qie 


die 


\^ 


ZO 


L 


I 


esc 


esc 


' r' 

L 


1 


esc 


esc 


yj 


z / 


'T 
J 


M' 


gs 


gs 


J 


'}' 


gs 


gs 




Zo 


cr 


cr 


ni 


r>1 

ni 


cr 


cr 


m 


nl 
ni 


U 




Ctrl 


Ctrl 


Ctrl 


Ctrl 


Ctrl 


Ctrl 


Ctrl 


Ctrl 


U 


30 


'e' 


'A' 


soh 


sob 


a 


'A' 


soh 


soh 




^1 

D X 






/if 




s 


'S' 








32 


'd' 


'D' 


eot 


eot 


u 


ly 


eot 


eot 


c 


33 


T 


'F' 


dck 


ack 


'f 


'F' 


ack 


ack 


(2 


34 


'g' 


'G' 


bel 


bel 


'g' 


'G' 


bel 


bel 


C 


35 


'h' 


'H' 


bs 


bs 


•h' 


'H' 


bs 


bs 


C 


36 


T 


'J' 


nl 


nl 


T 


'J' 


nl 


nl 


C 


37 


'k' 


'K' 


vt 


vt 


'k' 


'K' 


vt 


vt 


C 


38 


r 


'L' 


np 


np 


'1' 


'L' 


np 


np 


C 


39 






nop 


nop 






nop 


nop 


0 


40 


\' 




nop 


nop 


V' 




nop 


nop 


0 


41 






nop 


nop 






nop 


nop 


0 
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SCAN 
CODE 


BASE 


SHIFT 


CTRL 


CTRL 
SHIFT 


ALT 


ALT 
SHIFT 


ALT 
CTRL 


ALT 
CTRL 
SHIFT 


LOCK 


42 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


0 


43 


^v 


T 


fs 


fs 


^\' 


•I' 


fs 


fs 


0 


44 


'z' 


'Z' 


sub 


sub 


'z' 


'Z' 


sub 


sub 


C 


45 


'x' 


'X' 


can 


can 


'x' 


'X' 


can 


can 


C 


46 


'c' 


'C 


etx 


etx 


'c' 


'C 


etx 


etx 


C 


47 


'v' 


'V 


syn 


syn 


'v' 


'V 


syn 


syn 


C 


48 


'b' 


'B' 


stx 


stx 


'b' 


'B' 


stx 


stx 


C 


49 


'n' 


'N' 


so 


so 


*n' 


'N' 


so 


so 


C 


50 


'm' 


'M' 


cr 


cr 


'm' 


•M' 


cr 


cr 


c 


51 




'<' 


nop 


nop 


'/ 


'<* 


nop 


nop 


0 


52 




'>' 


nop 


nop 


'.' 


'>' 


nop 


nop 


0 


53 


V 


'?' 


nop 


nop 


V 


'?' 


nop 


nop 


0 


54 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


0 


55 


'*' 


'*' 


nscr 


nscr 


'*' 




nscr 


nscr 


0 


56 


alt 


alt 


alt 


alt 


alt 


alt 


alt 


alt 


0 


57 






' ' 


' ' 


' ' 


' ' 


' ' 


' ' 


0 


58 


clock 


clock 


clock 


clock 


clock 


clock 


clock 


clock 


0 


59 


fkeyl 


fkeyl 3 


fkey25 


fkey37 


scrl 


scrll 


scrl 


scrll 


0 


60 


fkey2 


fkeyl4 


fkey26 


fkey38 


sci2 


scrl2 


scr2 


scrl2 


0 


61 


fkeyS 


fkeyl5 


fkey27 


fkey39 


scr3 


scrl 3 


scr3 


scrl 3 


0 


62 


fkey4 


fkeyl 6 


fk:ey28 


fkey40 


scr4 


scrl4 


scr4 


scrl4 


0 


63 


fkeyS 


fkeyl7 


fkey29 


fkey41 


scr5 


scrl 5 


scr5 


scrl 5 


0 


64 


fkey6 


fkeyl 8 


fkeySO 


fkey42 


scr6 


scrl 6 


scr6 


scrl 6 


0 


65 


fkey7 


fkeyl9 


fkey31 


fkey43 


scr7 


scr7 


scr7 


scr7 


0 


66 


fkey8 


fkey20 


fkey32 


fkey44 


scr8 


scr8 


scr8 


scr8 


0 


67 


fkey9 


fkey21 


fkey33 


fkey45 


scr9 


scr9 


sci:9 


scr9 


0 


68 


fkeylO 


fkey22 


fkey34 


fkey46 


scrlO 


scrlO 


scrlO 


scrlO 


0 


69 


nlock 


nlock 


dc3 


dc3 


nlock 


nlock 


dc3 


dc3 


0 


70 


slcxik 


slock 


del 


del 


slock 


slock 


del 


del 


0 


71 


fkey49 


'7' 


•7' 


•7' 


'7' 


'7' 


'7' 


'T 


N 


72 


fkeySO 


'8' 


'8' 


'8' 


'8' 


'8' 


'8' 


'8' 


N 


73 


fkeySl 


'9' 


'9' 


'9' 


.9. 


.9. 


.9. 


'9' 


N 


74 


fkey52 


'.' 


'.' 


'.' 








'-' 


N 


75 


lkey53 


'4' 


'4' 


'4' 


'4' 


'4' 


'4' 


•4' 


N 


76 


fkey54 


'5' 


'5' 


'5' 


'5' 


'5' 


'5' 


'5' 


N 


77 


fkey55 


'6' 


•6' 


'6' 


'6' 


'6' 


'6' 


'6' 


N 


78 


fkey56 


'+' 


'+' 


'+' 


'+' 


'+' 


'+' 


'+' 


N 


79 


fkey57 


'1' 


'1' 


'1' 


'1' 


'1' 


'1' 


'1' 


N 


80 


fkey58 


'2' 


'2' 


'2' 


'2' 


'2' 


'2' 


'2' 


N 


81 


fkey59 


•3* 


'3' 


•3' 


•3' 


'3' 


•3' 


'3' 


N 


82 


fkey60 


•0' 


'0' 


'0' 


'0' 


•0' 


'0' 


'0' 


N 


83 


del 




del 


del 


del 


del 


del 


del 


N 


84 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


85 


fkeyll 


fkey23 


fkey35 


fkey47 


scrll 


scrll 


scrll 


scrll 


0 


86 


fkeyl2 


fkey24 


fkey36 


fkey48 


scrl2 


scrl2 


scrl2 


scrl2 


0 
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The following scan codes exist only for keyboards which support, and 
are in, native AT mode rather than PC compatibility mode. 



ALT 



Cr* AM 












AIT 


AI T 
J\Lil 


CTRL 






BASE 


oirrrrr 
SHjFT 


CTRL 


SHIFT 


ALT 


SHIFT 


CTRL 


SHIFT 




87 


fkeyll 


fk;ey23 


fkey35 


fkey47 


scrll 


scrll 


scrll 


scrll 


0 


88 


fkeyl2 


fkey24 


fkey36 


fkey48 


scrl2 


scrl2 


scrl2 


scrl2 


O 


89 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


90 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


91 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


92 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


93 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


94 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


oc 

ys 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


u 


yo 




iKeyji) 


ikeyjU 


fb-oT»sn 

iKeyjU 


iKeyju 


tkeyju 


iKcyjU 


iKcyDU 


u 


y 1 


iKcyj J 


iKeyj J 


iKeyjj 


iKeyjo 


iKeyj J 


fh-axiK'i 

iKeyjj 


iKeyjo 


iK&yjD 


u 


y© 




fkey58 


fkey58 


iKeyoo 


iKeyjo 


fkey58 


iKeyjo 


fkey58 


u 


QQ 




iKcyjj 


iKeyjj 


iKcyjj 


fl^ovr<S 

iKcyjj 


iKeyjj 


iKcyjj 


iKcyjj 


kJ 


inn 

lUU 


iKsyny 


iKcy''ty 


fUovr^Q 


iKcyHy 


fVo\/^Q 

iKcy'ty 


flrt^xiAQ 

iKcyfy 




fIrOYfilQ 

iKcy'ty 




ini 




iiteyj 1 


iKcyj 1 


iKcyj 1 


iK.cyj 1 


iKcyj 1 


iitcyj 1 


iKcyj 1 


KJ 


xuz 


iK.eyj / 


iKcyj / 


iiceyj / 


iKcyj / 


fb-axr'i'l 

iiteyj / 


iKcyj / 


iKcyj / 


iKcyj / 


r> 
\J 






fL-A\/<>Q 

iKcyjy 


iKcyjy 


fVf.T,CQ 

iK.cyj!7 


fVf.„<Q 

iiteyjy 


flro\;SO 


fVovSQ 

iK.cyj7 


fIroirSQ 

iKcyji» 


KJ 




iiceyou 


iKeyou 


iKeyou 


itceyou 


IKeyou 


IKeyou 


IKeyou 


IKeyou 


r\ 
k) 


ins 


rl<>1 
UCl 


Hoi 


Hoi 

del 


Hoi 


Hoi 
UCl 


Hoi 
UCl 


Hoi 
UCl 


Hoi 
UCl 


IN 


infi 


iiteyjT- 


iKcyj't 


iKcyj't 


flrovS4 


iKcyjt 






iKcyj'f 


KJ 


in7 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


ins 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 




nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


1 in 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


111 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 




nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


1 1 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


114 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


KJ 


115 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


116 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


117 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


118 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


119 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


120 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


121 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


122 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


123 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


124 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


125 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 
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ALT 



SCAN 








CTRL 




ALT 


ALT 


CTRL 




CODE 


BASE 


SHIFT 


CTRL 


SHIFT 


ALT 


SHIFT 


CTRL 


SHIFT 


LOCK 


126 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


127 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


0 


128 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


0 


129 


rait 


rait 


rait 


rait 


rait 


rait 


rait 


rait 


0 


130 


fkey60 


fkey60 


fkey60 


fkey60 


fkey60 


fkey60 


fkey60 


£key60 


o 


131 


del 


del 


del 


del 


del 


del 


del 


del 


N 


132 


fkey49 


fkey49 


fkey49 


fkey49 


fkey49 


fkey49 


fkey49 


fkey49 


0 


133 


flcey57 


fkey57 


fkey57 


fkey57 


fkeyS? 


fkeyS7 


fkeyS7 


fkeyS7 


0 


134 


fkeySl 


fkeySl 


fkeySl 


fkeySl 


fkeySl 


fkeySl 


fkeySl 


fkeySl 


0 


135 


fkey59 


fkey59 


fkey59 


fkeyS9 


fkeyS9 


fkeyS9 


fkeyS9 


fkeyS9 


0 


136 


fkey53 


fkey53 


fkey53 


fkeyS3 


fkeyS3 


fkeyS3 


fkeyS3 


fkeyS3 


0 


137 


fkey55 


fkey55 


fkey55 


fkeySS 


fkeySS 


fkeySS 


fkeySS 


fkeySS 


0 


138 


fkeySO 


fkeySO 


fkeySO 


fkeySO 


fkeySO 


fkeySO 


fkeySO 


fkeySO 


0 


139 


fkey58 


fkey58 


fkeySS 


fkeySS 


fkeySS 


fkeySS 


fkeySS 


fkeySS 


0 


140 


V 


nop 


nop 


nop 


V 


nop 


nop 


nop 


0 


141 


cr 


cr 


nl 


nl 


cr 


cr 


nl 


nl 


0 



The next table lists the "value" of each of the special keywords used 
in /usr/lib/keyboard/keys (and the preceding table). mapkey(M) 
places a "value" in the ioctl buffer during key mapping. The key- 
words are only used in the scan code file (/usr/lib/keyboard/keys) for 
readability. 



Name 


Value 


Meaning 


nop 


0 


No operation - no action from keypress 


Ishift 


2 


Left hand shift 


rshift 


3 


Right hand shift 


clock 


4 


Caps lock 


nlock 


5 


Numeric lock 


slock 


6 


Scroll lock 


alt 


7 


Alt key 


btab 


8 


Back tab key - generates fixed sequence (esc [ Z) 


Ctrl 


9 


Control key 


nscr 


10 


Switch to the next screen 


scrl 


11 


Switch to screen #1 


scrl6 


26 


Switch to screen #16 


fkeyl 


27 


Function key #1 


fkey96 


122 


Function key #96 


rctl 


128* 


Right Control Key 


rait 


129* 


Right Alt Key 



* AT mode keyboard only. 
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This table lists names and decimal values that are interchangeable in 
the mapkey file. Names are used in place of numeric constants to 
make it easier to read the scan code table. Again, only the decimal 
values are placed in the ioctl buffer. These are taken from ascii(M). 



Name 


Value 


Name 


Value 


nul 


0 


del 


17 


soh 


1 


dc2 


18 


stx 


2 


dc3 


19 


etx 


3 


dc4 


20 


eot 


4 


nak 


21 


enq 


5 


syn 


22 


ack 


6 


etb 


23 


bel 


7 


can 


24 


bs 


8 


em 


25 


ht 


9 


sub 


26 


nl 


10 


esc 


27 


vt 


11 


fs 


28 


np 


12 


gs 


29 


cr 


13 


rs 


30 


so 


14 


ns 


31 


si 


15 


del 


127 


die 


16 







Keyboard Mapping 



The PC keyboard is mapped as part of terminal emulation. This kind 
of mapping is performed only on the computer keyboard, not on 
remote terminals. Use mapkey to change keyboard mapping. To 
change the mapping for individual channels (multiscreens), use 
mapchan(}A). 

Keyboard mapping can also be performed using ioctl. The syntax is 
the same as for string key mapping (see previous section). 

For keyboard mapping, cmd is GIO_KEYMAP to display the current 
map, and PIO_KEYMAP puts the prepared buffer into place. 

String Key Mapping 



To map string (function) keys, use the mapstr (see mapkey(M)) utility. 
mapstr modifies the string mapping table where function keys are 
defined. 

The string mapping table is an array of 512 bytes (typedef strmap t) 
containing null terminated strings that redefine the function keys. The 
first null terminated string is assigned to the first string key, the 
second string to the second string key, and so on. 
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There is no limit to the length of any particular string as long as the 
whole table does not exceed 512 bytes, including nulls. Strings are 
made null by the introduction of extra null characters. 

The following is a list of default function key values: 



Default Function Key Values 



Key Number Function Key Function 



1 


Fl 


ESC [M 


2 


F2 


ESC [N 


3 


F3 


ESC [0 


4 


F4 


ESC[P 


5 


F5 


ESC [Q 


6 


F6 


ESC [R 


7 


F7 


ESC [S 


8 


F8 


ESC [T 


9 


F9 


ESC[U 


10 


FIO 


ESC [V 


11 


FU 


ESC[W 


12 


F12 


ESC [X 


13 


Shift-Fl 


ESC [Y 


14 


Shift-F2 


ESC[Z 


15 


Shift-F3 


ESC [a 


16 


Shift-F4 


ESC [b 


17 


Shift-F5 


ESC [c 


18 


Shift-F6 


ESC [d 


19 


Shift-F7 


ESC[e 


20 


Shift-F8 


ESC [f 


21 


Shift-F9 


ESC[g 


22 


Shift-FlO 


ESC [h 


23 


Shift-Fl 1 


ESC[i 


24 


Shift-F12 


ESC[j 


25 


Ctrl-Fl 


ESC[k 


26 


Ctrl-F2 


ESC[1 


27 


Ctrl-F3 


ESC [m 


28 


Ctrl-F4 


ESC [n 


29 


Ctrl-F5 


ESC [0 


30 


Ctrl-F6 


ESC[p 


31 


Ctrl-F7 


ESC[q 


32 


Ctrl-F8 


ESC[r 


33 


Ctrl-F9 


ESC [s 


34 


Ctrl-Fl 0 


ESC [t 


35 


Ctrl-Fl 1 


ESC[u 


36 


Ctrl-Fl 2 


ESC[v 
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Default Function Key Values (continued) 


K.ey Number 


Function K.ey 


runction 


51 


utri-oniit-ri 




19 

JO 


L,tri-5niit-r/ 




1Q 
jy 


\_tri-oniit-rj 


noL- Ly 


A(\ 
4U 


L.iri-oniii-r'4 




A 1 


utri-oniit-Jrj 


tloL. [(CO 


A'y 
4Z 


v_-iri- oniii-r" 0 


pj^r" rr 
lioi^ [L 


A1 


i^ui-oniii-r' / 




AA 


Ptrl <Ihift F8 
v^ui-OUiii ro 


F<IP n 
nov^ LJ 


4S 

HJ 




F<\P r 


Afi 

40 


Utri-oniit-rlU 




An 
4/ 


ctri-oniit-r 1 1 


i3C/~" r * 


AQ 

4o 


ctri-5niit-riz 


cc/"" r f 


AO 


Home 


FQr" ru 
HijC [rl 


^fi 

jU 


Up arrow 




CI 

Dl 


Page up 






Minus sign 






l^Cll oilUVV 


pcp rr> 


54 


5 


ESC[E 


55 


Ripht arrow 


ESCfC 


56 


Plus sign 


+ 


57 


End 


ESC[F 


58 


Down arrow 


ESC[B 


59 


Page down 


ESC[G 


60 


Insert 


ESC[L 



You can also map string keys using ioctl(S). The syntax is: 

♦include <SYs/keyboard.h> 
ioct 1 ( f d, cmd, buf ) 
int fd, cmd; 
char *buf; 



For string key mapping where cmd is GIO_STRMAP to display the 
string mapping table and PIO_STRMAP to put the new string mapping 
table in place. 
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/usr/lib/keyboard/keys 
/usr/lib/keyboard/strings 

See Also 



mapchan(F), mapchan(M), mapkey(M), multiscreen(M), screen(HW), 
setkey(C), stty(C), kbmode(ADM), configure(ADM) 
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Ip. IpO 

line printer device interfaces 

Description 

The IpO and Ipl files provide access to the parallel ports of the com- 
puter. 

Files 

/dev/lpO 

See Also 

lp(C), Ipadmin(ADM), Ipsched(ADM), pcu(ADM) 

Notes 

The standard Ip port, IpO, sends a printer initialization string the first 
time the file is opened after the system is booted. 
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mouse 



system mouse 
Description 



Altos UNIX System V supports mice attached directly to controller 
cards on the bus and mice attached to standard serial ports. The com- 
mand: 

mkdev mouse 

is used to configure a new mouse or to reconfigure an existing mouse. 

See Also 



mkdev(ADM), usemouse(C) 

Files 



/dev/mouse 

/dev/mouse/bus[0- 1 ] 

/dev/mouse/vpix[0- 1 ] 

/dev/mouse/microsoft_ser 

/dev/mouse/logitech_ser 

/dev/mouse/mousesys_ser 

/dev/mouse/ttyp[0-7] 

/etc/default/usemouse 

/usrAib/event/devices 

/usr/lib/event/ttys 

/usr/lib/mouse/* 

Value Added 



mouse is an extension of AT&T System V provided in Altos UNIX 
System V. 



Directory for mouse-related special device files. 
Bus mouse device files, 
vpix-mouse device files. 
Microsoft serial mouse device files. 
Logitech serial mouse device files. 
Mousesys serial mouse device files. 
Special pseudo-tty files for mouse input. 
Default map file for mouse-generated characters. 
File containing device information for mice. 
File listing ttys eligible to use mice. 
Alternate map files for mice. 
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parallel 



parallel interface devices 
Description 



This section describes the parallel port (LPTl) on the Base I/O Board: 
/dev/lpO Parallel port device 

For information on the TCU/2 parallel ports, refer to the appropriate 
TCU/2 documentation. 

If a parallel device fails to interrupt properly, the parallel driver enters 
"poll mode." Once interrupts are received from the device, the driver 
returns to its original mode. 

The parallel driver delays a certain amount of time when a parallel de- 
vice is closed. The amount of delay can affect printer performance, 
but is necessary to compensate for different sizes of printer buffers and 
printer speeds. For example, this command sets the delay on close to 
1 second, specified in lOths of a second: 

stty time lOc /dev/lpO 

When given from a prompt, this command will only work if the port is 
open. It is recommended that a variation of this command be placed 
in the interface script used with the parallel device to achieve the 
same results: 

stty time 10 (k &1 

Notes 



Parallel adapters on add-on cards will function, but switches must be 
set correctiy. 

In most cases, port control is best handled with the port configuration 
utility, pcu(ADM). 

The stty(C) command for output processing is supported on a parallel 
device, stty options that have no effect on a parallel device are 
ignored and no error messages are displayed. 

Usage 



Usually invoked by lp(C), but can be written to directiy. 
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Files 

/dev/lpO 

See Also 

lp(C), lp(HW), Ipadmin(ADM), Ipsched(ADM), serial(HW), 
pcu(ADM) 
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prf 



operating system profiler 
Description 



The special file /dev/prf provides access to activity information in the 
operating system. Writing the file loads the measurement facility with 
text addresses to be monitored. Reading the file returns these 
addresses and a set of counters indicative of activity between adjacent 
text addresses. 

The recording mechanism is driven by the system clock and samples 
the program counter at line frequency. Samples that catch the operat- 
ing system are matched against the stored text addresses and incre- 
ment corresponding counters for later processing. 

The file /dev/ prf is a pseudo-device with no associated hardware. 

Files 



/dev/prf 

See Also 



profiler(ADM) 
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ramdisk 



memory block device 
Description 



The ramdisk device driver provides a block interface to memory. A 
ramdisk can be used like any other block device, including making it 
into a file systems using mkfs(ADM). There are eight rarndisks avail- 
able. 

The characteristics of a ramdisk file are determined by its minor de- 
vice number. The bits in the minor device number encode its size, 
longevity, and which of the eight possible rarndisks it is. 

The three low-order bits of the minor device number determine which 
of the eight rarndisks is being accessed. 

The next four bits of the minor device number determine the size of 
the ramdisk. The size of a ramdisk must be a power of 2, and must be 
at least 16K. Since 4 bits are available, there are 16 possible sizes, 
starting at 16K and doubling every time the size indicator is incre- 
mented, to produce possible sizes of 16K, 32K, 64K, and up. 

The high-order bit is a longevity indicator. If set, memory is per- 
manently allocated to that ramdisk, and can be deallocated only by 
rebooting the system. Permanent ramdisks can only be allocated by 
the superuser. However, once a permanent ramdisk is allocated (by 
opening it), it can be read and written by anyone having the appropri- 
ate permissions on the ramdisk inode. 

If clear, the ramdisk is deallocated when no processes have it open. 
To create an easily removable, but semi-permanent ramdisk, use a 
separate process to keep the device open for as long as necessary. 

Since a complete set of ramdisks (8) would consume 256 inodes, only 
one example 16K ramdisk (/dev/ramOO) is created when the system is 
installed. The system administrator can check this existing file to 
determine the major device number for any other required ramdisks. 
All ramdisks will use the same major device number. 

The following table shows how the minor device number is con- 
structed: 
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Example Minor Device Number Construction 



Description Longe- Size (see Ram Minor 

vity next table) Disk No. Device 

Number 



16K (#1) 
(Temporary) 


0 


0 


0 


0 


0 


0 


0 


1 


1 


16K (#1) 
(Permanent) 


1 


0 


0 


0 


0 


0 


0 


1 


129 


64K (#0) 
(Temporary) 


0 


0 


0 


1 


0 


0 


0 


0 


16 


512K (#7) 
(Permanent) 


1 


0 


1 


0 


1 


1 


1 


1 


175 



The contents of the size field and the corresponding ramdisk size 
is shown in the next table. 



Size Bits 


Ramdisk Size 


0 


0 


0 


0 


16K 


0 


0 


0 


1 


32K 


0 


0 


1 


0 


64K 


0 


0 


1 


1 


128K 


0 


1 


0 


0 


256K 


0 


1 


0 


1 


512K 


0 


1 


1 


0 


IM 


0 


1 


1 


1 


2M 




0 


0 


0 


4M 




0 


0 


1 


8M 




0 


1 


0 


16M 




0 


1 


1 


32M 




1 


0 


0 


64M 




1 


0 


1 


128M 




1 


1 


0 


256M 




1 


1 


1 


512M 



To create a ramdisk, follow these steps: 
1. Create the device node. 

You must first create the device that the ramdisk will reside on. It has 
the form: 

mknod devicejiame b_or_c major _device_nuinber minor_device_number 

where b or e "b" or "c". "b" is for blocked devices and is the one 
you will use. The major number will always be 31. The minor num- 
ber is derived from the table above. The minor number is the sum of 
the three attribute columns. 
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Longevity: 

permanent = 128 non-permanent = 0 

Size: 

16K = 0 128K = 24 lMeg = 48 8Meg = 72 

32K = 8 256K = 32 2 Meg = 56 16 Meg = 80 

64K=16 512K = 40 4 Meg = 64 32 Meg = 88 

Ram Disk number: 0 through 7 Note: There are only 8 devices avail- 
able. Two different size devices may not share the same number. 

For example, to create a 64K permanent ramdisk, the minor number 
could vary from 144 to 151. If the disk number was 1 the mknod com- 
mand would be: 

mknod /dev/ram64 b 31 145 

2. Make a Hie system. 

This creates a file system on the the ramdisk. In this example mkfs 
has the form: 

mkfs device name size of file in Bsize blocks 

In this example, the command to create a 64K file system would be: 

mkfs /dev/ram64 64 

3. Mount the filesystem. 

This mounts the selected device on the specified mount point. It has 
the form: 

mount device_name mount_point 

In order to mount the example 64K ramdisk on /mnt the command 
would be: 

mount /dev/ram64 /mnt 

To make a file system on a non-permanent ramdisk, the device file 
must be held open between the mkfs and the mown? (ADM) operations. 
Otherwise, the ramdisk is allocated at the start of the mkfs command, 
and deallocated at its end. Once the ramdisk is mounted, it is open 
until it is unmounted. 
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The following shell fragment shows one way to use ml^s on a non- 
permanent 512K ramdisk, then mount it: 



( /etc/mkfs /dev/ram4 0 512 

/etc/mount /dev/ram40 /mnt 
) < /dev/ram40 

Notes 



ramdisks must occupy contiguous memory. If free memory is frag- 
mented, opening a ramdisk may fail even though there is enough total 
memory available. Ideally, all ramdisks should be allocated at system 
startup. This helps prevent the ramdisks themselves from fragmenting 
memory. 

ramdisks are geared towards use in specialized applications. In many 
cases, you will notice a decrease in system performance when ram- 
disks are used, because UNIX can generally put the memory to better 
use elsewhere. 

Files 



/dev/ramOO 

See Also 



mkfs(ADM), mount(ADM), mknod(C) 

Value Added 



ramdisk is an extension of AT&T System V provided in Altos UNIX 
System V. 
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rtc 



real time clock interface 
Description 



The rtc driver supports the real time clock chip, allowing it to be set 
with the correct local time and allowing the time to be read from the 
chip. 



loctl Calls 

RTCRTIME 

This call is used to read the local time from the real time clock 
chip. The argument to the ioctl is the address of a buffer of 
RTCNREG unsigned characters (RTCNREG is defined as 
<sys/rtc.h>). The ioctl will fill in the buffer with the contents of 
the chip registers. Currently, RTCNREG is 14, and the meanings 
of the byte registers are as follows: 



Register 


Contents 


0 


Seconds 


1 


Second alarm 


2 


Minutes 


3 


Minute alarm 


4 


Hours 


5 


Hour alarm 


6 


Day of week 


7 


Date of month 


8 


Month 


9 


Year 


A 


Status register A 


B 


Status register B 


C 


Status register C 


D 


Status register D 



For further information on the functions of these registers, see your 
hardware technical reference manual. 

RTCSTIME 

This call is used to set the time into the real time clock chip. The 
argument to the ioctl is the address of a buffer of RTCNREGP 
unsigned characters (RTCNREGP as defined in <sys/rtc.h>). 
These bytes should be the desired chip register contents. 
Currently, RTCNREGP is 10, representing registers 0-9 as shown 
above. Note that only the super-user may open the real time clock 
device for writing and that the RTCSTIME ioctl will fail for any 
other than the super-user. 
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Files 

/dev/rtc 
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screen 



tty[01-n], color, monochrome, ega, vga display adapter 
and video monitor 

Description 



The tty[01-n] device files provide character I/O between the system 
and the video display monitor and keyboard. Each file corresponds to 
a separate teletype device. Although there is a maximum of 12 
screens, the exact number available (w) depends upon the amount of 
memory in the computer. The screens are modeled after a 25 line, 80 
column ASCII terminal, unless specified otherwise. 

System error messages from the kernel are written to /dev/console, 
which is normally the current multiscreen. If the /dev/console is the 
default output device for system error messages, and the display being 
used is switched to graphics mode, console messages are not dis- 
played. When the video device returns to text mode, a notice message 
is displayed and the text of the kernel error can be recovered from 
usr/adm/messages. 

Although all tty[01-n] devices may be open concurrently, only one of 
the corresponding devices can be active at any given time. The active 
device displays its own screen and takes sole possession of the key- 
board. It is an error to attempt to access the color, monochrome, or 
ega file when no corresponding adapter exists or no multiscreens are 
associated with it. 

To get to the next consecutive screen, enter Ctrl-PrtSc using the Ctrl 
key, and the PrtSc key. Any active screen may be selected by enter- 
ing alt-Fn, where Fn is one of the function keys. For example, Fl 
refers to the ttyOl device. 

Control IVIodes 



Multiscreens can be reassigned to different adapters (in multi-adapter 
systems) with these ioctl s : 



SWAPMONO Selects the monochrome display as the output 

device for the multiscreen. 

SWAPCGA Selects the regular color display as the output 

device for the multiscreen. 
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SWAPEGA 



SWAPVGA 



Selects the enhanced color display as the out- 
put device for the multiscreen. 

Selects the video graphics array color display 
as the output device for the multiscreen. 



To find out which display adapter type is currently attached to the 
multiscreen, you can use ioctl(S) with the following request: 



CONS CURRENT 



Returns the display adapter type currently asso- 
ciated with the multiscreen. The return value 
can be one of: MONO, CGA, EGA, or VGA. 



Display Modes 



The following ioctls can be used to change the video display mode: 



SW B80x25 



SW C80x25 



SW B40x25 



SW C40x25 



SW BG320 



SW_CG320 



SW BG640 



Selects 80x25 black and white text display 
mode. (MONO, CGA, EGA, VGA) 

Selects 80x25 color text display mode. (CGA, 
EGA, VGA) 

Selects 40x25 black and white text display 
mode. (MONO, CGA, EGA, VGA) 

Selects 40x25 color text display mode. (CGA, 
EGA, VGA) 

Selects 320x200 black and white graphics 
display mode. (CGA, EGA, VGA) 

Selects 320x200 color graphics display mode. 
(CGA, EGA, VGA) 

Selects 640x200 black and white graphics 
display mode. (CGA, EGA, VGA) 



SW_EGAMONO80x25 Selects EGA (Enhanced Graphics Adapter) 
mode 7 - emulates support provided by the 
monochrome display. (EGA, VGA) 
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SW_EGAMONOAPA Selects EGA support for 640x350 graphics 

display mode (EGA mode F). (EGA with mono 
monitor) 

SW_ENHM0N0APA2 Selects EGA mode F*. (EGA with mono moni- 
tor) 

SW_ENHB40x25 Selects enhanced EGA support for 40x25 black 

and white text display mode. (EGA, VGA) 

SW_ENHC40x25 Selects enhanced EGA support for the 40x25 

color text display mode. (EGA, VGA) 

SW_ENHB80x25 Selects enhanced EGA support for 80x25 black 

and white text display mode. (EGA, VGA) 

SW_ENHC80x25 Selects enhanced EGA support for 80x25 color 

text display mode. (EGA, VGA) 

SW_ENHB80x43 Selects enhanced EGA support for 80x43 black 

and white text display mode. (EGA, VGA) 

SW_ENHC80x43 Selects enhanced EGA support for 80x43 color 

text display mode. (EGA, VGA) 

SW_CG320_D Selects EGA support for 320x200 graphics 

display mode. (EGA mode D.) (EGA, VGA) 

SW_CG640_E Selects EGA support for 640x200 graphics 

display mode (EGA mode E). (EGA, VGA) 

SW_CG640x350 Selects EGA support for 640x350 graphics 

display mode (EGA mode 10). (EGA, VGA) 

SW_ENH_CG640 Selects EGA mode 10*. (EGA, VGA) 

SW_MCAMODE Reinitializes the monochrome adapter. 

(MONO) 

SW_VGA40x25 Selects VGA support for the 40x25 color text 

display mode (VGA mode 1+). (VGA) 

SW_VGA80x25 Selects VGA support for the 80x25 black and 

white text display mode (VGA mode 2+), 
(VGA) 
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SW_VGAM80x25 

SW_VGA11 
SW_VGA12 
SW VGA13 



SCREEN (HW) 

Selects VGA mode 7+ - emulates support pro- 
vided by the monochrome display. (VGA with 
mono monitor) 

Selects VGA support for the 640x480 graphics 
display mode (VGA mode 1 1). (VGA) 

Selects VGA support for the 640x480 graphics 
display mode (VGA mode 12). (VGA) 

Selects VGA support for the 320x200 graphics 
display mode (VGA mode 13). (VGA) 



Switching to an invalid display mode for a display device will result 
in an error. 



Getting Display IVIodes 



The following ioctl( ) requests are provided to obtain information 
about the current display modes: 



CONS_GET Returns the current display mode setting for 

current display adapter. (All) 

CGA_GET Returns the current display mode setting of the 

color graphics adapter. (CGA only) 

EGA_GET Returns the current display mode setting of the 

enhanced graphics adapter. (EGA only) 

MCA_GET Returns the current display mode setting of the 

monochrome adapter. (MONO only) 

VGA_GET Returns the current display mode of the video 

graphics adapters. (VGA only) 



CONS_GETINFO Returns structure vidjnfo (below). Size of 

structure (first field) must be filled in by user. 

struct vid_info 
{ 



short size; 


/* 


must be first field 


*/ 


short m num; 


/* 


multiscreen number, 0 based 


V 


ushoirt ittv row, mv col; 


/* 


cursor position 


*/ 


ushort mv rsz, mv csz; 


/* 


text screen size 


*/ 


struct colors mv_norm. 


/* 


nornial attributes 


*/ 


mv_rev. 


/* 


reverse video attributes 




mv grfc; 


/* 


graphic character attributes 


V 


uchar t mv ovscan; 


/* 


border color 


*/ 


uchar_t mkjceylock; 


/* 


caps/num/scroll lock 


V 



}; 
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CONS_6845INFO 



struct m6845_info 
{ 



Returns structure m6845_info (below). Size of 
structure (first field) must be filled in by user. 



}; 



short size; /* must be first field */ 

ushort screen_top; /* offset of screen in video */ 
ushort ciirsor_type; /* cursor shape */ 



CONSADP 



GIO ATTR 



GIO COLOR 



GIO SCRNMAP 



Returns number of multiscreen displayed on 
adaptor associated with that multiscreen. 

Return value of ioctl is 6845-style attribute 
byte in effect. 

Return value of ioctl is zero or one depending 
on whether the device supports color 

Gets the 256-byte screen map table, which is 
the mapping of ASCII values (0-256) onto the 
PC video ROM font characters (0-256). Note 
that control characters (ASCII values less than 
hex 20) have control functions and do not 
display ROM characters (example: "J is new- 
line). 

This is often used to map the low font values 
that normally correspond to ASCII control 
values to higher ASCII values, thus displaying 
the desired ROM characters. 



PIO_SCRNMAP 

PIO_KEYMAP 
PIO_KEYMAP 
GIO FONTSXn 



Puts the 256-byte screen map table (see 
GIO_SCRNMAP). 

See keyboardQm) 

See keyboard(}m) 

Gets font, where n is 8, 14, and 16. Argument 
is a pointer to a font table. Size of 8X8 font 
table is 8X256 bytes, 8X14 is 14X256 bytes, 
etc. 



PI0_F0NT8Xn Puts font, where n is 8, 14, and 16. Argument is 

a pointer to a font table. Size of 8X8 font table 
is 8X256 bytes, 8X14 is 14X256 bytes, etc. 



January 16, 1991 



SCREEN-5 



SCREEN (HW) 

Memory Mapping Modes 



SCREEN (HW) 



The ioctl (S) routine is used to map the display memory of the various 
devices into the user's data space. 

Note that the MAP* ioctls map the memory associated with the 
current mode. You must put the adapter into the desired mode before 
performing mapping, or the pointers returned will not be appropriate. 
Refer to your hardware manual for details on various displays, 
adapters, and controllers. 

These ioctl {) requests can be used to map the display memory: 



MAPCONS 

MAPMONO 

MAPCGA 
MAPEGA 
MAPVGA 



Maps the display memory of the adaptor 
currently being used into the user's data space. 
(AH) 

Maps the monochrome adapter's display 
memory into the user's data space. (MONO 
only) 

Maps the color adapter's display memory into 
the user's data space. (CGA only) 

Maps the enhanced graphics adapter's display 
memory into the user's data space. (EGA only) 

Maps the video graphics adapter's display 
memory into the user's data space. (VGA only) 



For example, the following code can be used to acquire a pointer to 
the start of the user data space associated with the color graphics 
adapter display memory: 

char *dp; 
int retval; 



/* fd is a file descriptor for a 

multiscreen device */ 
retval = ioctl (fd, MAPCONS, OL) ; 
dp = (char *) retval; 



Note that when the display memory is mapped into the user space, the 
adapter's m6845 start address registers are not set. The start address 
can be reset in two ways, so that the start address of the display mem- 
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ory corresponds to the upper left hand comer of the screen: 

1. Switch modes with an ioctlQ (the "switch" can be to the 
present mode). See the "Display Modes" section of this manu- 
al page. 

2. Change the start address high and low address with the 
in-on-port/ out-on-port ioctlQ. 

The in-on-porti out-on-port ioctl()'s can also be used to determine the 
current value in the start address register, and then set up a pointer to 
point to the offset in the mapped-in data space. 

MAP.CLASS 

Package ioctl that gives I/O privileges to an arbitrary list of ports 
and maps an arbitrary frame buffer into user's address space 
identified by a string found in the struct vidclass vidclasslist[] 
located in /etc/conf/pack.o/class.h. 

KDDISPTYPE 

This call returns display information to the user. The argument 
expected is the buffer address of a structure of type kd disparam 
into which display information is returned to the user. The 
kd disparam structure is defined as follows: 

struct kdjdisparam { 

long type; /*display type*/ 

char *addr; /*display memory address*/ 

ushort ioaddr [MEODIOADDR] ; /*valid I/O addresses*/ 



Possible values for the type field include: 

KD_MONO (0x01), for the IBM monochrome display adapter. 

KD_HERCIJLES (0x02), for the Hercules monochrome graphics 
adapter. 

KD_CGA (0x03), for the IBM color graphics adapter. 
KD_EGA (0x04), for the IBM enhanced graphics adapter. 
KD_VGA (0x05), for the IBM video graphics adapter. 
KDDISPINFO 

Returns struct kd disparam, which contains adaptor type and phy- 
sical address of frame buffer. 

KIOCSOUND 

Start sound generation. Turn on sound. The arg is the frequency 
desired. A frequency of 0 turns off the sound. This is useful for 
generating tones while in graphics mode. 
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KDGETLED 

Get keyboard LED status. The argument is a pointer to a charac- 
ter. The character will be filled with a boolean combination of the 
following values: 

1 scroll lock 

2 num lock 
4 caps lock 

KDSETLED 

Set keyboard LED status. The argument is a character whose 
value is the boolean combination of the values listed under 
"KDGETLED". 

KDMKTONE 

Not supported. (See KIOCSOUND.) 

KDADDIO 

Not supported. (See MAP_CLASS.) 

KDDELIO 

Not supported. (See MAP_CLASS.) 

KIOCDOSMODE 
Not supported. 

KIOCNONDOSMODE 
Not supported. 

KDSETMODE 

(VP/IX only.) Set console in text or graphics mode. The argument 
is of type integer, which should contain one of the following 
values: 

KD_TEXT 0x00 ( sets console to text mode ) 

KD_GRAPHICS 0x01 ( sets console in graphics mode ) 

Note, the user is responsible for programming the color/graphics 
adaptor registers for the appropriate graphical state. 

KDGETMODE 

(VP/IX only.) Get current mode of console. Returns integer argu- 
ment containing either KD_TEXT or KD_GRAPHICS as defined 
in the KDSETMODE ioctl description. 

KDENABIO 

Enable in's and out's to video adaptor ports. No argument. 
KDDISABIO 

Disable in's and out's to video adaptor ports. No argument. 

KDGKBTYPE 
Always retums 0. 
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KDGKBMODE 

Get keyborad translation mode, also known as scan code mode. 
Mode is returned where arg points. 

KDSKBMODE 

Set keyborad translation mode, also known as scan code mode. 
KDGKBSTATE 

Returns the state of the shifted, alt-, or control- state of the key- 
board. Returns a boUean combination of: 

1 shifted 

2 control- 
4 alt- 

KIOCINFO 

Always returns 0x6664. 

KDMAPDISP 

(VP/ix only) Maps display memory into user process address 
space. Argument is a pointer to structure type kd memloc. This 
ioctl requires that a virtual 8086 subtask be attached to the current 
process. KDMAPDISP should not be used by ordinary users to 
map the console display; use MAPCONS. 

KDUNMAPDISP 

(VP/ix only) Unmap display memory from user process address 
space. No argument required. 

VT_SETMODE 

Set the virtual terminal mode. The argument is a pointer to a 
vt_mode structure, as defined below. 

VT_GETMODE 

Determine what mode the active virtual terminal is currently in, 
either VT_AUTO or VT_PROCESS. The argument to the ioctl is 
the address of the following type of structure: 

stmact vtjtnode { 

char mode; /* VT mode */ 

char waitv; /* not irtplemented */ 

short relsig; /* signal to use for release request */ 

short acqsig; /* signal to use for display acquired */ 

short frsig; /* not iitplemented */ 

} 

#def ine VT_AUTO 0x00 /* automatic VT switching */ 

#define VT_PROCESS 0x01 /* process controls switching */ 

The vt_mode structure will be filled in with the current value for each 
field. 
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VT.RELDISP 

Used to tell the virtual terminal manager that the display has or has 
not been released by the process. 

0 == release refused 

1 == release acknowledged 

2 == acquire acknowledged 

VT.ACTIVATE 

Makes the multiscreen number specified in the argument the active 
multiscreen. The video driver will cause a switch to occur in the 
same manner as if a hotkey sequence had been typed at the key- 
board. If the specified multiscreen is not open or does not exist, 
the call will fail and ermo will be set to ENXIO. 

Graphics Adapter Port I/O 



You can use ioctl(S) to read or write a byte from or to the graphics 
adapter port. The arg parameter of the ioctl call uses the io arg data 
structure: 

struct port_io_arg { 

struct port_io_struct args[4]; 

}; 

As shown above, the io arg structure points to an array of four port io 
data structures. The port io structure has the following format: 

struct port_io_struct { 

char dir; /* direction flag (in vs. out) */ 
unsigned short port; /* port address */ 
char data; /* byte of data */ 

}; 

You may specify one, two, three, or four of the port Jo struct struc- 
tures in the array for one ioctl call. The value of dir can be either 
IN_ON_PORT to specify a byte being input to the graphics adapter 
port or OUT_ON_PORT to specify a byte being output to the graphics 
adapter port. Port is an integer specifying the port address of the 
desired graphics adapter port. Data is the byte of data being input or 
output as specified by the call. 

If you are not using any of the port io structures, load the port with 0, 
and leave the unused structures at the end of the array. Refer to the 
hardware manuals for port addresses and functions for the various 
adapters. 

You can use the following ioctl(S) commands to input or output a byte 
on the graphics adapter port: 
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CONSIO Inputs or outputs a byte on the current graphics 

adapter port as specified. (All) 

MGAIO Inputs or outputs a byte on the monochrome 

adapter port as specified. (MONO only) 

CGAIO Inputs or outputs a byte on the color graphics 

adapter port as specified. (CGA only) 

EGAIO Inputs or outputs a byte on the enhanced graph- 

ics adapter port as specified, (EGA only) 

VGAIO Inputs or outputs a byte on the video graphics 

array adapter port as specified. (VGA only) 



To input a byte on any of the graphics adapter ports, load dir with 
IN_ON_PORT and load port with the port address of the graphics 
adapter. The byte input from the graphics adapter port will be returned 
in data. 

To output a byte, load dir with OUT_ON_PORT, load port with the 
port address of the graphics adapter, and load data with the byte you 
want output to the graphics adapter port. 

Function Keys 



ioctl(S) can be used to define or obtain the current definition of a func- 
tion key. The arg parameter of the ioctl call uses the fkeyarg data 
structure: 

struct fkeyarg { 

unassigned int keynum; 
char keydef [MAXFK] ; 
/* Comes from 

char flen; ioctl. h via comcrt.h */ 

} 

You can use the following ioctl(S) requests to obtain or assign func- 
tion key definitions: 

GETFKEY 



Obtains the current definition of a function key. 
The function key number must be passed in 
keynum. The string currently assigned to the 
key will be returned in keydef and the length of 
the string will be returned in flen when the ioctl 
is performed. 
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SETFKEY Assigns a given string to a function key. The 

function key number must be passed in keydef 
and the length of the string (number of charac- 
ters) must be passed in flen. 

SETLOCKLOCK Toggles the <Caps Lock> and <Num Lock> 

keys to be either global to all the multiscreens, 
or local to each individual multiscreen. To 
make the <Caps Lock> global (its default), set 
the arg parameter to 1. To make the 
<Caps Lock> local to each screen, set the arg 
parameter to 0. 

ANSI Screen Attribute Sequences 



The following character sequences are defined by ANSI X3.64-1979 
and may be used to control and modify the screen display. Each n is 
replaced by the appropriate ASCII number (decimal) to produce the 
desired effect. The last column is for termcap(M) codes, where "n/a" 
means not applicable. 

The use of 7 or 8 bit characters in the escape sequence is a valid invo- 
cation for each action defined. For example the ANSI ED command 
can be invoked via the "ESC [ n J" (0xlb-0x5b-n-0x4a, 7 bit chars) 
sequence or the "CSI n J" (0x9b-n-0x4n, 8 bit chars) sequence. 



ISO 

ED 

(Erase in 
Display) 



EL 

(Erase in 
Line) 



ECH 

(Erase 

Character) 



Sequence Action 

CSI/i J Erases all or part of a 
display. n=0: erases from 
active position to end of 
display. n=l : erases from 
the beginning of display to 
active position. n=2 : 
erases entire display. 

CSI n K Erases all or part of a Une. 

n=0: erases from active 
position to end of line. 
n=l : erases from begin- 
ning of line to active posi- 
tion. n=2 : erases entire 
line. 

CSI n X Erases n characters 



Termcap 
Code 

cd 



ce 



n/a 
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CBT 
(Cursor 
Backward 
Tabulation) 



SU 

(Scroll 
Up) 

SD 

(Scroll 
Down) 

CUP 

(Cursor 

Position) 

HVP 

(Horizontal 
& Vertical 
Position) 

CUU 

(Cursor Up) 

CUD 

(Cursor 

Down) 

CUF 

(Cursor 

Forward) 

CUB 

(Cursor 

Backward) 

HPA 

(Horizontal 

Position 

Absolute) 

HPR 

(Horizontal 

Position 

Relative) 
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CSIn Z Moves active position bt 
back n tab stops. 



CSIn S Scroll screen up n lines, sf 

introducing new blank 
lines at bottom. 

CSIn T Scrolls screen down n sr 

lines, introducing new 
blank lines at top. 

CSIm;n H Moves active position to cm 
location m (vertical) and n 
(horizontal). 

CSIm;n f Moves active position to n/a 
location m (vertical) and n 
(horizontal). 



CSI n A Moves active position up n up (ku) 

number of lines. 

CSI n B Moves active position do (kd) 

down n number of lines. 



CSI n C Moves active position n nd (kr) 

spaces to the right. 



CSI n D Moves active position n bs (kl) 

spaces backward. 



CSIn * Moves active position to n/a 

column given by n. 



CSIn a Moves active position n n/a 

characters to the right. 
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VPA 
(Vertical 
Position 
Absolute) 



CSI« d Moves active position to n/a 

line given by n. 



VPR 
(Vertical 
Position 
Relative) 



CSIn e Moves active position n/a 

down n number of lines. 



IL 

(Insert 
Line) 



CSI n L Inserts n new, blank lines. 



al 



ICH 

(Insert 

Character) 



CSI n @ Inserts n blank places for n 

characters. 



ic 



DL 

(Delete 
Line) 



CSI n M Deletes n lines. 



dl 



DCH 

(Delete 

Character) 



CSIn P Deletes n number of char- dc 

acters. 



CPL 

(Cursor to 

Previous 

Line) 



CSIn F Moves active position to 

beginning of line, n lines 
up. 



n/a 



CNL 
(Cursor 
Next 
Line) 



CSIn E Moves active position to 

beginning of line, n lines 
down. 



n/a 
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SGR CSIn m 

(Select 

Graphic 

Rendition) 



Character attributes, as n/a 
summarized in the chart 
below. Multiple attributes 
can be specified in the 
form: CSI nl; n2;n3m 



Select Graphic Rendition (SGR) Chart 


n 




Meaning 


0 


all attributes off (normal display) 


1 


bold intensity (or light color) 


4 


underscore on (if hardware supports it) 


5 


blink on (if hardware supports it) 


7 


reverse video 




8 


sets blank (non-display) 


10 


selects the primary font 


11 


selects the first alternate font: lets ASCII 




characters less 


than 32 be displayed as 




ROM characters 


12 


selects a second alternate font; toggles high 




bit of extended ASCII code before display- 




ing as ROM characters 


30 


black 


foreground 


31 


red 


foreground 


32 


green 


foreground 


33 


brown 


foreground 


34 


blue 


foreground 


35 


magenta 


foreground 


36 


cyan 


foreground 


37 


white 


foreground 


38 


enables underline option; white foreground 




with white underscore 


39 


disables underline option 


40 


black 


background 


41 


red 


background 


42 


green 


background 


43 


brown 


background 


44 


blue 


background 


45 


magenta 


background 


46 


cyan 


background 


47 


white 


background 
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ISO Sequence Action Termcap 
Code 

SM CSI[2h Lock keyboard. Ignores n/a 
(Set Mode) keyboard input until 

unlocked. Characters are 

not saved. 

MC CSI[2i Send screen to host. n/a 
(Media Current screen contents are 
Copy) sent to the application. 

RM CSI[21 Unlock keyboard. Re- n/a 

(Reset enable keyboard input. 

Mode) 



Additional Screen Attribute Sequences 

Name Sequence Action ^Code^^ 

n/a CSl=p;dB Set the bell parameter to the n/a 

decimal values of p and d. p is 
the period of the bell tone in units 
of 840.3 nanoseconds, and d is the 
duration of the tone in units of 
100 milliseconds. 

n/a CSI = j';eC Set the cursor to start on scanline n/a 

s and end on scanline e. 

n/a CSI=jcD Turn on or off (;c=l or 0) the n/a 

intensity of the background color. 

n/a CSI=xE Set or clear (x=l or 0) the Blink n/a 

vs. Bold background bit in the 
6845 crt controller, 

n/a CSI = cA Set overscan color to color c. cis n/a 

a decimal value taken from Color 
Table above. (This sequence may 
not be supported on all hardware.) 

n/a CSI = cF Set normal foreground color to c. n/a 

(c is a decimal parameter taken 
from Color Table.) 
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n/a CSI = 

n/a CSI- 

n/a CSI = 

n/a CSI = 
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cOG Set normal background. (See n/a 

Color Table.) 

c H Set reverse foreground. (See n/a 

Color Table.) 

c I Set reverse background. (See n/a 

Color Table.) 

c J Set graphic foreground. (See n/a 

Color Table.) 

c K Set graphic background. (See n/a 

Color Table.) 



Color Table 



Cn 


Color 


Cn 


Color 


0 


Black 


8 


Grey 


1 


Blue 


9 


Lt. Blue 


2 


Green 


10 


Lt. Green 


3 


Cyan 


11 


Lt. Cyan 


4 


Red 


12 


Lt.Red 


5 


Magenta 


13 


Lt. Magenta 


6 


Brown 


14 


Yellow 


7 


White 


15 


Lt. White 
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Name 



Sequence 



Action 



Termcap 
Code 



n/a CSI[«g 



n/a ESC Q¥n 'string 



n/a CSI n z 



Accesses alternate graphics set. n/a 
Not the same as 
"graphics mode." Refer to your 
owner's manual for 

decimal/character codes (Pn) and 
possible output characters. 

Define function key Fn with n/a 
string. String delimiters 
' and ' may be any character not 
in string. Fn is defined as the key 
number starting at zero plus the 
ASCII value of zero. For exam- 
ple, Fl = 0... F16 = ?, and so on. 

In this escape sequence, the 
character will cause the next 
character to have 32 subtracted 
from its ASCII value. Thus "! 
results in a soh ("A) characters. 

n should be equal to the number n/a 
of the screen to switch to. If 
screen does not exist, no action 
will take place. 



Files 



/dev/console 

/dev/tty [02 -n] 

/dev/color 

/dev/monochrome 

/dev/ega 

/dev/vga 

See Also 



console(M), ioctl(S), keyboard (HW), keymap(M), mapkey(M), 
mapchan(M), multiscreen (M), setcolor(C), stty(C), systty(M), 
vidi(C), termcap(M), tty(M) 
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scsi 



small computer systems interface 
Description 



The Small Computer Systems Interface (SCSI) provides a standard 
interface for peripherals such as hard disks, printers, tape drives and 
others, SCSI is run via a host adapter card that can support up to 7 de- 
vices each. The Base I/O Board contains one host adapter (sometimes 
referred to as "SCSI channel"), whereas High Performance File Pro- 
cessor boards (HPFPs) support up to two host adapters each, with mul- 
tiple HPFPs supported as well. 

The minor device numbering scheme for SCSI disk devices is the 
same as the standard minor device number scheme for non-SCSI disk 
devices, with the exception that multiple major numbers are allowed 
(up to 16 contiguous major numbers). 

The minor device numbering scheme for SCSI tape devices is as fol- 
lows: 

SCSI Tape Minor Devices 

Bits 

7 6 5 4 3 2 1 0 Description 
X ------ - Override device 

X X - - - - - Data density 

X - - - - Variable length 

X - - - No rewind on close 
XXX Unit number 

See Also 



hd(HW), tape(HW), System Administrator's Guide 

Value Added 



scsi is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V, 
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serial: tty1[a-h] , tty1[A-H] , tty2[a-hl , 
tty2[A-H] 



interface to serial ports 
Description 



This section describes the COMl and COM2 serial ports. For infor- 
mation on the serial ports available with the Multidrop (MDC/2) or 
the Serial Concentrator (SIO/2) boards, refer to the appropriate hard- 
ware manual accompanying appropriate to your configuration. 

The ttyl[a-h], ttyl[A-H], tty2[a-h] and tty2[A-H] files provide 
access to the standard and optional serial ports of the computer. Each 
file corresponds to one of the serial ports (with or without modem con- 
trol). Files are named according to the following conventions: 

- The first number in the file name corresponds to the COM expan- 
sion slot. 

- Lower case letters indicate no modem control. 

- Upper case letters indicate the line has modem control. 

ttyla and ttylA both refer to COM 1, whereas tty2a and tty2A both 
refer to COM 2. 

The COMl and COM2 ports each have modem and non-modem invo- 
cations. The device names in the following table refer to the serial 
ports, with and without modem control. The first section of the table 
describes boards at COM 1 and the second section describes boards 
installed at COM 2. "Minor" is the minor device number for the port 
(see mknodiC)). 
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Serial Lines 


Board 
Type 


Non-Modem 
Control 
Minor Name 


Modem Control 
Minor Name 






1 Port 


0 


ttyla 


128 


ttylA 




4 Port 


1 

2 
3 


ttylb 
ttylc 
ttyld 


129 
130 
131 


ttylB 
ttylC 
ttylD 


8 Port 


4 
5 
6 
7 


ttyle 
ttylf 
ttylg 
ttylh 


132 
133 
134 
135 


ttylE 
ttylF 
ttylG 
ttylH 






1 Port 


8 


tty2a 


136 


tty2A 




4 Port 


9 
10 
11 


tty2b 
tty2c 
tty2d 


137 
138 
139 


tty2B 
tty2C 
tty2D 


8 Port 


12 
13 
14 
15 


tty2e 
tty2f 
tty2g 
tty2h 


140 
141 
142 
143 


tty2E 
tty2F 
tty2G 
tty2H 



Interrupt Vectors: 



All board(s) installed at COM 1 - 4 
All board(s) installed at COM 2 - 4 

For a list of I/O addresses, see the Release Notes furnished with your 
distribution. 

Access 



The files may only be accessed if the corresponding serial interface 
card is installed and its jumper I/O address correctly set. Also, for 
multi-port expansion cards, you must use the mkdev(ADM) program to 
create more than the default number of files. Unless other COM slots 
are specifically referred to in your hardware documentation, only 
COM 1 and COM 2 may be used. 

The serial ports must also be defined in the system configuration. 
Check your hardware manual to determine how your system is config- 
ured, via a CMOS database or by switch settings on the main system 
board. If your system is configured using a CMOS database, the ports 
are defined in the database (see cmos(lTW)). Otherwise, define the 
ports by setting the proper switches on the main system board. Refer 
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to your computer hardware manual for switch settings. 

It is an error to attempt to access a serial port that has not been 
installed and defined. 

The serial ports can be used for a variety of serial communication pur- 
poses such as connecting login terminals to the computer, attaching 
printers, or forming a serial network with other computers. Note that a 
serial port may operate at most of the standard baud rates, and that the 
ports (on most computers) have a DTE (Data Terminal Equipment) 
configuration. The following table defines how each pin is used for 
25-pin and 9-pin connections: 



25-Pin 


9-Pin 


Description 


2 


2 


Transmit Data 


3 


3 


Receive Data 


4 


7 


Request to Send 


5 


8 


Clear to Send 


7 


5 


Signal Ground 


8 


1 


Carrier Detect (Data Set Ready) 


20 


4 


Data Terminal Ready 



Only pins 2, 3, and 7 (2,3 and 5 for 9-pin) are necessary for a terminal 
(or direct) connection. 

A modem control device (port) uses pins 2, 3, and 7 in the same way 
as a non-modem control device: send on pin 2 and receive on pin 3. 
Pin 7 is data ground. On a non-modem control device, pins 4 and 20 
(RTS and DTR) are asserted, but pin 8 is not. On a modem control de- 
vice, pins 4 and 20 (RTS & DTR) are asserted and the port will not 
open until pin 8 (CXD) is asserted. That is, no signal travels from pin 
2 until pin 8 is asserted from another source. The modem control de- 
vice monitors the the status of pin 8. 

See tty(M) and termio(M) for the details of serial line operation on 
UNIX systems. 

Files 



/dev/ttyl[a-h] 
/dev/ttyl[A-H] 
/dev/tty2[a-h] 
/dev/tty2[A-H] 

See Also 



cmos(HW), csh(C), cu(C), getty(ADM), mkdev(ADM), mknod(C) 
nohup(C), open(S), termio(M), tty(M), uucp(C) 
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If you login via a modem control serial line, hanging up logs that line 
out and kills your background processes. See nohup(C) and csh(C)). 

You cannot use the same serial port with both modem and non-modem 
control at the same time. For example, you cannot use ttyla and ttylA 
simultaneously. 

Use a modem cable to connect your modem to a computer. 
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tape 



magnetic tape device 
Description 



The tape device implements the UNIX interface with a tape drive. 
QIC-02 cartridge tape drives are supported by the ct device driver, 
QIC-40 and QIC-80 tape drives connected to the floppy disk controller 
are supported with the ft device driver, and Irwin tape drives con- 
nected to the floppy disk controller are supported with the ir device 
driver. 

Typically, the tar(C), cpioiC), dd(CX backup (ADM), xbackup (ADM), 
xrestore (ADM), or restore (ADM) commands are used to access a 
tape drive. 

A single tape drive with a raw (character, non-blocking) interface is 
supported, except for the SCSI tape driver which supports up to eight 
devices. 

There are numerous "types" offered for each tape device, resulting in 
numerous device files for a single tape device. (See "Files" section.) 
The general naming format for common tape device types is shown 
below: 

/dev/[n] [v] [Ilmlh] [r] [Stplctlftlir]jc 
where: 



n 


no rewind 


r 


raw device 


V 


variable block size 


Stp 


SCSI tape device 


I 


low-density format 


ct 


cartridge tape device (QIC-02) 


m 


medium-density format 


ft 


tape attached to floppy controller 


h 


high-density format 


ir 


Irwin tape (floppy controller) 






X 


the unique tape device number 



Other tape types include these special prefixes: 

e ECC error recovery device x special control device 

These device types and their filename codes are described in the fol- 
lowing paragraphs. 

Currently, eight tape devices are supported, numbered 0 through 7. 
For example, the first raw cartridge tape device is /dev/rctO. 
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Devices beginning with the "r" prefix, (for "raw device"), should be 
used for most normal tape work, while devices with the *'n" prefix, 
("for no rewind on hold"), should be used for storing and restoring 
multiple files. Devices beginning with the "x" prefix are control de- 
vices, which are used for sending ioctl(S) commands to the tape sub- 
system. 

For SCSI 9-track tapes, there will be two variable length devices: 
vrStpA: and nvrStpx (for the no-rewind device). They will always be 
created when a SCSI tape drive is added, but they can only be used 
with 9-track devices that support variable length. 

SCSI 9-track and Exabyte tape drives should be added with mkdev 
tape and by choosing the SCSI options. 

Devices beginning with the "e" prefix (for ECC device) support a 
2/64 error recovery scheme. Thus two 512-byte blocks out of every 64 
blocks can be bad and the driver will correct the errors. This software 
ECC support provides a high degree of error recovery. 

The ft and ir floppy tape drivers do not support the "n" or "e" device 
types. ECC encoding and decoding is automatically used with the 
standard "r" device. On the QIC-40, QIC-80 and Irwin 80MB drives, 
for every 29K written to the tape, 3K of ECC data is written with it to 
provide error recovery. On the Irwin 10, 20, 40 and 60MB drives, for 
every I6K written to the tape, 2K of ECC data is written. 

QIC-40 and QIC-80 tapes must be formatted with the tape(C) com- 
mand before use, unless you use pre-formatted tapes. Similarly, Irwin 
tapes must be first servo- written and then formatted with tape(C) 
before use, unless you use pre-formatted tapes. The ir driver can read 
tapes formatted and written under UNIX but cannot write to them. 

The density-format prefixes "1", "m", and "n", force the specified 
tape device to read and write data in "low", "medium", or "high" 
density format, regardless of the drive's auto-sensing capabilities. 
Thus, a Tandberg tape drive will attempt to write in qic-320 format 
(high-density) if a DC 6525 tape is inserted and the drive is allowed to 
choose a format. By using the medium-density device file, the user 
can cause the drive to write in qic-150 format, so that the resulting 
tape is readable by devices that are capable of reading only qic-150 
format tapes. 

Another, less obvious, use of forcing drives to read at a specified den- 
sity enables you to determine the density of an unknown tape. To 
determine what density a tape has been written in, try to read the tape 
at the three different density devices for your tape drive. The device 
that successfully reads the tape indicates the tape density. 

Tape device filenames without any of these three density- specifying 
prefixes indicates a "default-density" device, in which the tape de- 
vice sets the density to its default value. 
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The following table shows how specifying density via the device 
filename prefix (1, m, h, or default) affects the tape format used by 
various brands of tape drives: 



DENSITY 


MANUFACTURER 




Tandberg 


Archive Wangtek 


Qualstar 


Default 
Low (1) 
Medium (m) 
High (h) 


Auto-Senses 
QIC-120 
QIC-150 
QIC-320 


Auto-senses Auto-senses 
QIC-24* QIC-24* 
QIC-120 QIC-120 
QIC-150 QIC-150 


6250 bpit 
1600 bpi 
3200 bpi 
6250 bpi 



* Read only. 

t Auto-senses only on read. 

Note that when auto-sensing by default (as shown above), a tape de- 
vice writes at the highest density possible. However, when auto- 
sensing during a read, the drive will read at any density within its 
repertoire, whichever approrpiate. Also note that a drive may be capa- 
ble of reading or writing in a density not listed in the above table. 
Except as noted, any drive not listed above will only use its default 
density, regardless of it full capabilities. 

Exabyte drives are only capable of reading and writing a single den- 
sity. This density is not defined by the ANSI SCSI specification, and 
so varies from model to model. 

The table below shows the maximum density (format) possible for 
selected tape sizes. 

TAPE MAX. 
SIZE DENSITY 

6526 QIC-320 

6150 QIC-150 

600XTD QIC-150 

600A QIC-120 

300XLP QIC-24 

The following table summarizes the base naming conventions for the 
tape drives supported: 



ctO,l QIC24 unit 0,1 

ct2,3 QICll unit 0,1 

Stp0,l,2,3,4,5,6,7 SCSI tape unit 0,1,2,3,4,5,6,7 

ftO QIC-40 or QIC-80 floppy tape unit 

irO Irwin floppy tape unit 

ctmini default mini-cartridge device 



The default tape device is stored in the file /etc/default/tape, which is 
also used by tape(C.). /etc/default/tape should always contain the "x" 
(control) device name of the default device, and is normally updated 
by the mkdev tape command. If the default device is an QIC-40, 
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QIC-80 or Irwin tape drive, the appropriate device from the table 
above will be linked to the ctmini device node. QIC-02 tape drives 
will always be accessed by the ctOJ device nodes as shown in the 
table. If a SCSI tape drive is installed as the default device and there 
is no QIC-02 drive installed, it will be linked to the ctO device node. 
If both SCSI and QIC-02 drives are installed, the SCSI device node 
cannot be linked to the ctO device node. 

tape(C) describes the commands used to access tape drives. 

Definition of iocti commands 



The following ioctl commands can be used with the various tape de- 
vice drivers supported under UNIX. The letters following each 
description indicate which drivers support each ioctl command: 

A All drivers 

C QIC-02 cartridge tape driver 

S SCSI tape driver 

F QIC-40 and QIC-80 mini-cartridge tape drivers 

I frwin mini-cartridge tape driver 



MT_STATUS 

Returns a device-independent structure holding the status of the 
drive. The tapeinfo structure is defined in 
/usr/include/sys/tape.h. (A) 

MT_DSTATUS 

Returns a device-dependent structure holding status information of 
the drive. If this command does not seem to work, use 
stp_status(dev) instead. (A) 

MT_RESET 

Resets the driver software and the tape drive. Interrupts tape com- 
mands in progress. (C,F,I) 

MT_REPORT 

Returns an integer code which determines the type of device which 
the driver controls. The type numbers are defined in 
/usr/include/sys/tape.h. (A) 

MT_RETEN 

Winds the tape forward to EOT and then backward to BOT. (A) 

MT_REWIND 

Rewinds the tape to BOT. (A) 

MT_ERASE 

Erases the data on the tape and retensions the cartridge. (C,S J^) 
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MT_AMOUNT 

Returns an integer count of the amount of the last data transfer. 
This command will fail if there is no tape in the drive. (A) 

MT_FORMAT 

Formats the tape. Expects as an argument the number of tracks to 
format, which must be an even number. If no argument is pro- 
vided, the default is 20 tracks for QIC-40 drives, 28 tracks for 
QIC-80 drives, and from 8 to 32 tracks for Irwin drives, depending 
on the capacity of the tape. On Irwin drives, the tape must previ- 
ously have been servo-written before formatting, either by the 
manufacturer or with the MT_SERVO command. (F,I) 

MT_GETHDR 

Expects as an argument a pointer to a struct ft header or struct 
ir header and copies the header of the current tape into it. (F,I) 

MT_PUTHDR 

Takes a pointer to a struct ft header or struct ir header and writes 
it onto the tape. This command should be used with caution. (F,I) 

MT_GETNEWBB 

Takes a pointer to a struct fi newbbt or struct ir newbbt and copies 
in a list of bad blocks detected on the last write operation. (F,I) 

MT_PUTNEWBB 

Takes a pointer to a struct ft newbbt or struct ir newbbt, reads in 
the header from the tape, then writes a new bad block onto the tape 
with the new bad blocks from the provided bad block table. (F,I) 

MT_GETVTBL 

Takes a pointer to a struct ft vtbl and copies in the volume table 
from the tape. (F) 

MT_PUTVTBL 

Takes a pointer to a struct ft vtbl and writes the volume table onto 
the tape. This command should be used with caution. (F) 

MT_SERVO 

Writes servo marks on a blank tape in preparation for formatting 
with MT_FORMAT. If the tape has previously been servo-written, 
this command may fail unless the tape is first bulk-erased with a 
commercial tape eraser. Normally, a tape should only be servo- 
written once in its lifetime, although it can be formatted many 
times. (I) 

MT_RFM 

Winds the tape forward to the next file mark. (C,S) 
MT_WFM 

Writes a file mark at the current location on the tape. (C,S) 
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MT_LOAD 

On devices which are capable of doing so, loads the tape into the 
drive. (S) 

MT_UNLOAD 

On devices which are capable of doing so, unloads the tape from 
the drive. (S) 



Files 



For a common SCSI tape drive: 



/dev/hrStpx 

/dev/kStpx 

/dev/mrStp;c 

/dev/nhrStpx 

/dev/nlrStpx 



/dev/nmrStpx 

/dev/nrStpx 

/dev/nvhrStpjc 

/dev/nvkStpjc 

/dev/nvmrStpx 



A selection of other tape drives: 



/dev/nvrStpx 

/dev/rStpx 

/dev/vhrStpx 

/dev/vlrStp;c 

/dev/vmrStpx 



/dev/vrStpjT 
/dev/xStpx: 



/d&y/xfvc /dev/rirjc 
/dev/rftc /dev/nrctc 
/dev/xirjc /dev/rctc 

Include files: 

/usrAnclude/sys/tape.h 
/usr/include/ sy s/ct.h 
/usr/include/sys/ft.h 
/usr/include/sys/ir.h 



/dev/erctc 
/dev/xctc 
/dev/xctmini 



/dev/retmini 



Notes 



After certain tape operations are executed, the system returns a 
prompt before the tape controller has finished its operation. If the user 
enters another tape command too quickly, a "device busy" error is 
returned until the tape device is finished with its previous operation. 

Periodic tape cartridge retensioning and tape head cleaning are neces- 
sary for continued error-free operation of the tape subsystem. Use 
tape(C) to retension the tape. 



See Also 



backup(ADM), xbackup(ADM), cpio(C), dd(C), format(C), tape(C), 
tar(C), restore(ADM), xrestore(ADM) 
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terminal 

login terminal 

Description 

A terminal is any device used to enter and display data. It may be 
connected to the computer: 

- By a serial wire, either direct or dialup 

- As a virtual terminal, for example witfi emulator software 

- Through a display adapter 

A terminal has an associated device file /dev/tty*. 

Set up ports for use by terminals with the pcu(ADM) command. 

Files 

/dev/tty* 

See Also 

console(M), disable(C), enable(C), mkdev(ADM), serial(HW), stty(C), 
vidi(C), termcap(M), term(F), terminals(M), pcu(ADM) 
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xt 



multiplexed tty driver for AT&T windowing terminals 
Description 



The xt driver provides virtual tty(M) circuits multiplexed onto real 
tty (M) lines. It interposes its own channel multiplexing protocol as a 
line discipline betv^een the real device driver and the standard tty(M) 
line disciplines. 

Virtual tty(M) circuits are named by character- special files of the 
form Idevixt???. File names end in three digits, where the first two 
represent the channel group and the last represents the virtual tty(M) 
number (0-7) of the channel group. Allocation of a new channel group 
is done dynamically by attempting to open a name ending in 0 with 
the 0_EXCL flag set. After a successful open, the tty(M) file onto 
which the channels are to be multiplexed should be passed to xt via 
the XTIOCLINK ioctl(S) request. Afterwards, all the channels in the 
group will behave as normal tty (M) files, with data passed in packets 
via the real tty(M) line. 

The xt driver implements the protocol described in xtproto(M) and in 
layers (M). Packets are formatted as described in xtproto(M), while 
the contents of packets conform to the description in layers (M). 

There are three groups of ioctl(S) requests recognized by xt. The first 
group contains all the normal tty ioctl(S) requests described in 
termio(M), with the addition of the following: 

TIOCEXCL Set exclusive use mode; no further opens are per- 

mitted until the file has been closed. 

TIOCNXCL Reset exclusive use mode; further opens are once 

again permitted. 

The second group of ioctl(S) requests concerns control of the window- 
ing terminal, and is described in the header file <sys/jioctl.h>. The 
requests are as follows: 

JTYPE, JMPX Both return the value JMPX. These are used to 
identify a terminal device as an xt channel. 

JBOOT, JTERM Both generate an appropriate command packet to 
the windowing terminal affecting the layer asso- 
ciated with the file descriptor argument to 
ioctl (S). They may return the error code EIO if 
the system clist is empty. 
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JTIMO.JTIMOM JTIMO specifies the timeouts in seconds, and 
JTIMOM in milliseconds. Invalid except on 
channel 0. They may return the error code EIO if 
the system clist is empty. 

JWINSIZE Requires the address of a jwinsize structure as an 

argument. The window sizes of the layer associ- 
ated widi the file descriptor argument to ioctl(S) 
are copied to the structure. 

JZOMBOOT Generate a command packet to the windowing 
terminal to enter download mode on the channel 
associated with the file descriptor argument to 
ioctl(S), like JBOOT; but when the download is 
finished, make the layer a zombie (ready for 
debugging). It may return the error code EIO if 
the system clist is empty. 

JAGENT Send the supplied data as a command packet to 

invoke a windowing terminal agent routine, and 
return the terminal's response to the calling pro- 
cess. Invalid except on the file descriptor for 
channel 0. See jagent(M). It may return the 
error code EIO if the system clist is empty. 

The third group of ioctl(S) requests concerns the configuration of xt, 
and is described in the header file <sys/xt.h>. The requests are as fol- 
lows: 

XTIOCTYPE Returns the value XTIOCTYPE. 

XTIOCLINK Requires an argument that is a structure, xtioclm , 
containing a file descriptor for the file to be mul- 
tiplexed and the maximum number of channels 
allowed. Invalid except on channel 0. This 
request may retum one of the following errors: 

EINVAL nchans has an illegal value. 

ENOTTY fd does not describe a real ffy(M) de- 
vice. 

ENXIO linesw is not configured with xt. 

EBUSY An XTIOCLINK request has already 
been issued for the channel group. 



ENOMEM There is no system memory available 
for allocating to the rfy(HW) struc- 
tures. 
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EIO The JTIMOM packet described above 

could not be delivered. 

HXTIOCLINK Like XTIOCLINK, but specifies that EN<X>DING 
MODE be used. 

XTIOCTRACE Requires the address of a tbuf structure as an 
argument. The structure is filled with the con- 
tents of the driver trace buffer. Tracing is 
enabled. This request is invalid if tracing is not 
configured. 

XTIOCNOTRACE Tracing is disabled. This request is invalid if 
tracing is not configured. 

XTIOCSTATS Requires an argument that is the address of an 
array of size S_NSTATS, of type Stats J. The 
array is filled with the contents of the driver 
statistics array. This request is invalid if statis- 
tics are not configured. 

XTIOCDATA Requires the address of a maximum-sized Link 

structure as an argument. The structure is filled 
with the contents of the driver Link data. This 
request is invalid if data extraction is not config- 
ured. 



Files 



/dev/xt/??[0-7] multiplexed special files 

/usr/include/sys/jioctl.h packet command types 

/usr/include/sys/xtproto.h channel multiplexing protocol definitions 

/usrAnclude/sys/xt.h driver specific definitions 

See Also 



layers(C), termio(M), tty(M), ioctl(S), open(S), libwindows(S), 
jagent(M), layers(M) 
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Commands, System Calls, Library Routines and File Formats 



This permuted index is derived from the "Name" description lines found on each 
reference manual page. Each index line shows the title of the entry to which the line 
refers, followed by the reference manual section letter where the page is found. 

To use the permuted index search the middle column for a key word or phrase. The right 
hand column contains the name and section letter of the manual page that documents 
the key word or phrase. The left column contains additional useful information about 
the command. Commands or routines are also listed in the context of the index line, 
followed by a colon (:). This denotes the "beginning" of the sentence. Notice that in 
many cases, the lines wrap, starting in the middle column and ending in the left column. 
A slash (/) indicates that the description line is truncated. 



fiinctionsofDASI 300/ 
fiinctionsofDASV 300: 
fiinctionsofDASI 
ofDASl300/ 300: 300, 
ofDASI 300 and 
cofifconv: Convert 
13tol, ltol3: Converts between 
TEKTRONIX 4014 tenninal 
paginator for flie TEKTRONIX 
the DASI 450 terminal 
functions of the DASI 
accepts a number of 
/object downloader for the 
between long integer and base 
i286emul: emulate 
x286emul: emulate XENIX 
Object Modules. 86rel: Intel 
asx: XENIX 
Format for Object Modules, 
long integer and base 64 ASCII. 
Format of UUCP dial-code 

value. 

abs: Returns an integer 
and/ /fabs, ceil, fmod: Performs 
integer, labs: Returns the 
blocks. 

Synchronizes shared data 
files, settime: Changes die 
utime: Sets file 



300: 300, 300s - handle special . . 300(C) 

300, 300s -handle special .... 300(C) 

300 and 300s terminals /special . 300(C) 

300s - handle special fiinctions . . 300(C) 

300s terminals /functions .... 300(C) 

386 COFF files to XENIX fonnat. . coffconv(M) 

3-byte integers and long/ .... 13tol(S) 

4014: paginator for the 4014(C) 

4014 tenninal 4014: 4014(C) 

450: handle special functions of . 450(C) 

450 tenninal /handle special . . . 450(C) 

5 1 2-byte blocks login(M) 

5620 DMD terminal wtinit(ADM) 

64 ASCII. a641, 164a: Converts . . a641(S) 

80286 i286emul(C) 

80286 x286emul(C) 

8086 Relocatable Fonnat for . . . 86rel(F) 

8086/186/286/386 Assembler. . . asx(CP) 

86rel: Intel 8086 Relocatable . . . 86rel(F) 

a641, 164a: Converts between . . . a641(S) 

abbreviations file, dialcodes: . . . dialcodes(F) 

abort: Generates an JOT fault. . . abort(S) 

abs: Returns an integer absolute . abs(S) 

absolute value abs(S) 

absolute value, floor, ceiling . . . floor(S) 

absolute value of a long labs(DOS) 

accepts a number of 51 2-byte . . login(M) 

access, sdgetv, sdwaitv: .... sdgetv(S) 

access and modification dates of . settime(ADM) 

access and modification times. . . utime(S) 



M 
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a file, touch: Updates access and modification times of . touch(C) 

of a file, access: Determines accessibility . access(S) 

dosls, dosrni, dosrmdir: Access DOS files dos(C) 

directory, chmod: Changes the access permissions of a file or . . chmod(C) 

Idfcn: common object file access routines ldfcn(F) 

sulogin: access single-user mode sulogin(ADM) 

filesystems for optimal access time /copy UNIX .... dcopy(ADM) 

a/ Aibwaitsem: Awaits and checks access to a resource governed by . waitsem(S) 

sdenter, sdleave: Synchronizes access to a shared data segment. . sdenter(S) 

sputl, sgetl: Accesses long integer data in a/ . . sputl(S) 

endutent, utmpname: Accesses utmp file entry getut(S) 

access: Detennines accessibility of a file access(S) 

csplit: Splits files according to context csplit(C) 

Enables or disables process accounting, acct: acct(S) 

accton: TXims on accounting accton(ADM) 

acctprcl, acctprc2 -process accounting acctprc: acctprc(ADM) 

runacct: run daily accounting runacct(ADM) 

tumacct - shell procedures for accounting /shutacct, startup, . . acctsh(ADM) 

/accton, acctwtmp - overview of accounting and miscellaneous/ . . acct(ADM) 

of accounting and miscellaneous accounting commands /- overview acct(ADM) 

diskusg: generate disk accounting data by user ID ... . diskusg(ADM) 

acct: Format of per-process accounting file acct(F) 

Searches for and prints process accounting files, acctcom: .... acctcom(ADM) 

acctmerg: merge or add total accounting files acctmerg(ADM) 

command summary from per-process accounting records acctcms: . . . acctcms(ADM) 

wtmpfix: manipulate connect accounting records /fwtmp, . , . fwtmp(ADM) 

accton, acctwtmp - overview of/ acct: acctdisk, acctdusg, acct(ADM) 

process accounting, acct: Enables or disables .... acct(S) 

accounting file, acct: Format of per-process . . . acct(F) 

per-process accoxmting records acctcms: command sunmiary from . acctcms(ADM) 

process accounting files, acctcom: Searches for and prints . acctcom(ADM) 

acctwtmp - overview of/ acct: acctdisk, acctdusg, accton acct(ADM) 

overview ofi' acct: acctdisk, acctdusg, accton, acctwtmp - . . . acct(ADM) 

accoimting files acctmerg: merge or add total . . . acctmerg(ADM) 

acct: acctdisk, acctdusg, accton, acctwtmp - overview of/ . acct(ADM) 

accton: 'Rims on accounting. . . . accton(ADM) 

process accoimting acctprc: acctprcl, acctprc2 - . . . acctprc(ADM) 

accounting acctprc: acctprcl, acctprc2 - process . . . acctprc(ADM) 

acctprc: acctprcl, acctprc2 - process accounting . . acctprc(ADM) 

dodisk, lastlogin, monaccty acctsh: chargefee, ckpacct, . . . acctsh(ADM) 

acctdisk, acctdusg, accton, acctwtmp - overview of/ acct: . . acct(ADM) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ . . . trig(S) 

initcond: special security actions for init and getty initcond(ADM) 

/interface for audit subsystem activation, termination auditcmd(ADM) 

kiUaU: kill aU active processes kiUall(ADM) 

Prints current sees file editing activity, sact: sact(CP) 

information about system activity, uptime: Displays .... uptime(C) 

report process data and system activity timex: time a command; . timex(ADM) 

sag: system activity graph sag(ADM) 

sar, sal, sa2, sadc - system activity report package sar: . . . sar(ADM) 

debugger, adb: Invokes a general-purpose . . adb(CP) 
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vdutil: add a virtual disk vdutil(ADM) 

add.vd: add a virtual disk add.vd(ADM) 

device driver/ idinstall: add, delete, update, or get .... idinstall(ADM) 

XENlX-style/ addxusers: add new user accounts given a/ . . addxusers(ADM) 

kernel configuration/ idaddld: add or remove line disciplines from idaddld(ADM) 

acctmerg: merge or add total accounting files .... acctmerg(ADM) 

paramters to be adjusted when adding more memory memtune(F) 

Copies bytes from a specific address, movedata: movedata(DOS) 

checkaddr: MMDF address verification program . . . checkaddr(ADM) 

nl: Adds line numbers to a file. . . . nl(Q 

lineprinters. Ipinit: Adds, reconfigures and maintains . lpinit(ADM) 

swapadd: Adds swap area swapadd(S) 

putenv: Changes or adds value to environment. . . . putenv(S) 

match system/ adjusts tunable parameters to . . idmemtune(ADM) 

sees files, admin: Creates and administers . . admin(CP) 

LP print service Ipfilter: administer filters used with the . . lpfilter(ADM) 

LP print service Ipforms: administer forms used with the . . Ipfonns(ADM) 

admin: Creates and administers SCCS files admin(CP) 

netutil: Administers the XENIX netwoik. . netutil(ADM) 

uuinstall: Administers UUCP control files. . uuinstall(ADM) 

networic listener service administration nlsadmin: .... nlsadmin(ADM) 

/Menu driven at and cron administration utility atcronsh(ADM) 

Menu driven Ip print service administration utility Ipsh: . . . Ipsh(ADM) 

auditsh: Menu driven audit administration utility auditsh(ADM) 

backupsh: Menu driven backup administration utility backupsh(ADM) 

sysadmsh: Menu driven system administration utility sysadmsh(ADM) 

uadmin: administrative control uadmin(ADM) 

uadmin: administrative control uadmin(S) 

swap: swap administrative interface swap(ADM) 

authorization/ authtsh: administrator interface for .... authtsh(ADM) 

alarm: Sets a process' alarm clock. alarm(S) 

clock, alarm: Sets a process' alarm . . . alarm(S) 

/MMDF hashed database of alias and routing information. . . dbmbuild(ADM) 

mmdfalias: converts XENIX-style aliases file to MMDF/ mmdfalias(ADM) 

bricctl: Allocates data in a far segment. . . bricctl(S) 

malloc, free, realloc, caUoc: Allocates main memory malloc(S) 

brk: Changes data segment space allocation, sbric, sbik(S) 

file, inittab: Alternative login terminals . . . inittab(F) 

Generates programs for lexical analysis, lex: lex(CP) 

reduce: perform audit data analysis and reduction reduce(ADM) 

temporarily privs: print and/or restrict privileges privs(C) 

link editor output. a.out: Format of assembler and . . a.out(F) 

ar: Archive file format ar(F) 

libraries, ar: Maintains archives and .... ar(CP) 

dc: Invokes an arbitrary precision calculator. . . dc(C) 

cpio: Format of cpio archive cpio(F) 

the names of files on a backup archive, dumpdir: Prints .... dumpdir(C) 

otar: original tape archive command otar(C) 

pax: portable archive exchange pax(C) 

ar: Archive file format ar(F) 

tar: archive format tar(F) 
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ar: Maintains archives and libraiies ar(CP) 

tar: Archives files tar(Q 

cpio: Copies file archives in and out cpio(C) 

ranlib: Converts archives to random libraries. . . . ranlib(CP) 

swapadd: Adds swap area swapadd(S) 

output of a varargj argument list. /Prints formatted . . vprintf(S) 

varargs: variable argument list varargs(S) 

getopt: Gets option letter from argument vector getopt(S) 

echo: Echoes arguments echo(0 

expr: Evaluates arguments as an expression. . . . expr(C) 

between long integer and base 64 ASQI. a641, 164a: Converts . . . a641(S) 

tzset: Converts date and time to ASQI. ^time, asctime, .... ctime(S) 

ascii: Map of the ASCII character set ascii(M) 

character set ascii: Map of the ASQI ascii(M) 

atof, atoi, atol: Converts ASCII to numbers atof(S) 

pscat: ASai-to-PDstScript filter .... pscat(C) 

and/ ctime, localtime, gmtime, asctime, tzset: Converts date . . . ctime(S) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: ttig(S) 

commands, help: Asks for help about SCCS .... help(CP) 

time of day. asktime: Prompts for the correct . asktime(ADM) 

asx: XENIX 8086/186/286/386 Assembler asx(CP) 

masm: Invokes the XENIX assembler masm(CP) 

output. a.out: Format of assembler and link editor .... a.out(F) 

program, assert: Helps verify validity of . . assert(S) 

deassigns devices, assign, deassign: Assigns and . . assign(Q 

assign, deassign: Assigns and deassigns devices. . . assign(C) 

setbuf, setvbuf: Assigns buffering to a stream. . . setbuf(S) 

setkey: Assigns the function keys setkey(C) 

Qose the event queue and all associated devices. ev_close: . . ev_close(S) 

Assembler, asx: XENIX 8086/186/286/386 . . asx(CP) 

a later time, at, batch: Executes commands at . at(Q 

sin, cos, tan, asin, acos, atan, atan2: Performs/ trig(S) 

sin, cos, tan, asin, acos, atan, atan2: Performs trigonometric/ . . trig(S) 

cron administration utility atcronsh: Menu driven at and . . . atcronsh(ADM) 

to numbers, atof, atoi, atol: Converts ASCII . . atof(S) 

double-precision/ strtod, atof: Converts a string to a .... strtod(S) 

numbers, atof, atoi, atol: Converts ASCII to . . . atof(S) 

integer, strtol, atol, atoi: Converts string to strtol(S) 

integer, strtol, atol, atoi: Converts string to ... strtol(S) 

atof, atoi, atol: Converts ASCII to numbers. . atof(S) 

fllesystem backup/ restore: AT&T UNIX incremental .... restore(ADM) 

QIC-24/QIC-02 tape/ tapecntl: AT&T tape control for tapecnUCC) 

xt: multiplexed tty driver for AT&T windowing terminals . . . xt(HW) 

/Print file to printer attached to a serial console . . . consoleprint(ADM) 

Iprint: Print to a printer attached to the user's terminal . . Iprint(C) 

data segment, sdget, sdfree: Attaches and detaches a shared . . sdget(S) 

tunable parameter idtune: attempts to set value of a .... idtune(ADM) 

auditsh: Menu driven audit administration utility .... auditsh(ADM) 

device audit: audit subsystem interface . . audit(ADM) 

by the audit/ auditd: read audit collection files generated . . auditd(ADM) 

reduction reduce: perform audit data analysis and reduce(ADM) 
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events dlvr_audit: produce audit records for subsystem . . . dlvr_audit(ADM) 

auditcmd: command interface for audit subsystem activationy . . . auditcmd(ADM) 

files generated by the audit subsystem and /collection . auditd(ADM) 

audit: audit subsystem interface device . audit(ADM) 

audit subsystem activation^ auditcmd: command interface for . auditcmd(ADM) 

files generated by the audit/ auditd: read audit collection . . . auditd(ADM) 

chg_audit: enables and disable auditing for the next session . . . chg_audit(ADM) 

administration utility auditsh: Menu driven audit . . . auditsh(ADM) 

authcap: authentication database . authcap(ADM) 

consistency of Authentication/ authck: check internal authck(ADM) 

checker authckrc: trusted computing base . tcbck(ADM) 

/examine system files against authentication database integrity(ADM) 

autficap: authentication database authcap(ADM) 

check internal consistency of Authentication database authck: . authck(ADM) 

/administrator interface for authorization subsystem authtsh(ADM) 

for authorization subsystem authtsh: administrator interface . . authtsh(ADM) 

the system, autoboot: Automatically boots . . autoboot(ADM) 

schedule: Database for automated system backups .... schedule(ADM) 

autoboot: Automatically boots the system. . autoboot(ADM) 

resource/ waitsem, nbwaitsem: Awaits and checks access to a . . waitsem(S) 

processes, wait: Awaits completion of background . wait(C) 

a pattern in a file, awk: Searches for and processes . awk(Q 

wait: Awaits completion of background processes wait(C) 

Performs incremental file system backup, backup: backup(ADM) 

error-checking filesystem backup fsave: Interactive, .... fsave(ADM) 

incremental filesystem backup. /Performs XENIX .... xbackup(ADM) 

backupsh: Menu driven backup administration utility . . . backupsh(ADM) 

Prints the names of files on a backup archive, dumpdir: .... dumpdir(0 

sddate: Prints and sets backup dates sddate(C) 

/Default backup device informatioa . . . archive(F) 

backup: performs UNIX backup functions backup(ADM) 

format, backup: Incremental dump tape . . backup(F) 

file system backup, backup: Performs incremental . . backup(ADM) 

backup fimctions backup: performs UNIX backup(ADM) 

incremental filesystem backup restore /UNIX restore(ADM) 

Database for automated system backups schedule: schedule(ADM) 

periodic semi-automated system backups fsphoto: Performs . . . fsphoto(ADM) 

administration utility backupsh: Menu driven backup . . backupsh(ADM) 

vdutil: repair bad block on a mirrored disk . . . vdutil(ADM) 

vdutil: display bad blocks for a mirrored disk . . vdutil(ADM) 

fixed disk for flaws and creates bad track table, badtrk: Scans . . badtric(ADM) 

flaws and creates bad track/ badtric: Scans fixed disk for ... badtric(ADM) 

banner: Prints large letters banner(Q 

Terminal capability data base, termcap: termcap(M) 

and sets the configuration data base, cmos: Displays cmos(HW) 

and sets the configuration data base, cmos: Displays cmos(HW-86) 

terminal capability data base, "terminfo:" terminfo(M) 

between long integer and baseMASQI. /164a: Converts . . a641(S) 

names from pathnames, basename: Removes directory . . basename(Q 

later time, at, batch: Executes commands at a . . at(C) 

be: Invokes a calculator bc(C) 
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initialization/ brc: brc, bcheckrc - system brc(ADM) 

for diff. bdiffi Compares files too large . . bdifiR^C) 

bdos: Invokes a DOS system call. . bdos(DOS) 

cb: Beautifies C programs cb(CP) 

jO,jl,jn,yO,yl,yn: Performs Bessel functions, bessel, .... bessel(S) 

Performs Bessel functions, bessel, jO,jl,jn,yO,yl,yn: . . . bessel(S) 

bfs: Scans big files bfs(C) 

mail uudecode: decode a binary file for transmission via . . uuencode(Q 

mail uuencode: encode a binary file for transmission via . . uuencode(Q 

fixhdr: Changes executable binary file headers fixhdr(C) 

selected parts of executable binary files, hdr: Displays .... hdr(CP) 

fread, fwrite: Performs buffered binary input and output fread(S) 

bsearch: Performs a binary search bsearch(S) 

tfind, tdelete, twalk: Manages binary search trees, tsearch, . . . tsearch(S) 

Creates an instance of a binary semaphore, creatsem: . . . creatsem(S) 

Removes symbols and relocation bits, strip: strip(CP) 

rmb: remove extra blank lines from a file rmb(M) 

shutdn: Flushes block I/O and halts the CPU. . . . shutdn(S) 

cmchk: Reports hard disk block size cmchk(C) 

accepts a number of 51 2-byte blocks login(M) 

df: Report number of free disk blocks df(C) 

Calculates checksum and counts blocks in a file, sum: sum(Q 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

boot: XENIX boot program boot(HW) 

boot: XENIX boot program. . . . boot(HW) 

autoboot: Automatically boots the system autoboot(ADM) 

initialization procedures brc: brc, bcheckrc - system brc(ADM) 

initialization procedures brc: brc, bcheckrc - system .... brc(ADM) 

allocation, sbik, bik: Changes data segment space . sbik(S) 

segment. bikcU: Allocates data in a far . . . bikctl(S) 

search, bsearch: Performs a binary .... bsearch(S) 

a character to the console buffer, ungetch: Returns .... ungetch(DOS) 

output, fread, fwrite: Performs buffered binary input and .... fread(S) 

stdio: Performs standard buffered input and output stdio(S) 

setbuf, setvbuf: Assigns buffering to a stream. ...... setbuf(S) 

flushall: Flushes all output buffers flushall(DOS) 

idbuild: build new UNIX system kernel . . idbuild(ADM) 

kernel. link_unix: buUds a new UNIX system .... link_unix(ADM) 

mknod: Builds special files mknod(C) 

database of alias and/ dbmbuild: builds the MMDF hashed . . . . dbmbuild(ADM) 

inp: Returns a byte inp(DOS) 

ou^: Writes a byte to an output port outp(DOS) 

swab: Swaps bytes. swab(S) 

movedata: Copies bytes from a specific address. . . movedata(DOS) 

cc: Invokes the C compiler cc(CP) 

cflow: Generates C flow graph cflow(CP) 

cpp: The C language preprocessor. .... cpp(CP) 

lint: Checks C language usage and syntax. . . lint(CP) 

cxref: Generates C program cross-reference. . . . cxref(CP) 

cb: Beautifies C programs cb(CP) 

xref: Cross-references C programs. xref(CP) 
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xstr: Extracts strings from C programs xstr(CP) 

an error message file from C source, mkstr Creates .... mkstr(CP) 

distance, hypot, cabs: Determines Euclidean . . . hypot(S) 

cal: Prints a calendar. cal(0 

values strmcfg: calculate STREAMS parameter . . strmcfg(ADM) 

blocks in a file, sum: Calculates checksum and counts . sum(Q 

Invokes an arbitrary precision calculator, dc: dc(C) 

be: Invokes a calculator. bc(C) 

cal: Prints a calendar. cal(Q 

service, calendar: Invokes a reminder . . . calendar(C) 

Data returned by Stat system caU. stat: . stat(F) 

bdos: Invokes a DOS system call fados(DOS) 

intdos: Invokes a DOS system call intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

exit: Terminates the calling process exit(DOS) 

maUoc, free, realloc, calloc: Allocates main memory. . . malloc(S) 

cu: Calls another XENIX system. . . cu(C) 

requests to lineprinter. Ip, cancel: Send/cancel lp(C) 

lineprinter. Ip cancel: Send/cancel requests to . . lp(C) 

termcap: Terminal capability data base tenncap(M) 

"terminfo: terminal" capability data base. . . 

description into a terminfo/ captoinfo: convert a termcap . . . captoinfo(ADM) 

pnch: file format for card images pnch(F) 

text editor (variant of ex for casual users) edit: edit(C) 

files, cat: Concatenates and displays . . cat(C) 

cb: Beautifies C programs cb(CP) 

cc: Invokes the C compiler, . . . cc(CP) 

cd: Changes woridng directory. . . cd(C) 

commentary of an SCCS delta, cdc: Changes the delta cdc(CP) 

hs: High Sierra ISO-9660 CD-ROM filesystem hs(F) 

hs: High Sierra/ISO-9600 CD-ROM fUesystem hs(F) 

value, floor,/ floor, fabs, ceil, fmod: Performs absolute . . . floor(S) 

/Performs absolute value, floor, ceiling and remainder functions. . floor(S) 

cflow: Generates C flow graph. . . cflow(CP) 

cgets: Gets a string cgets(DOS) 

delta: Makes a delta (change) to an SCCS file delta(CP) 

allocation, sbric, brie: Changes data segment space . . . sbric(S) 

headers, fixhdr: Changes executable binary file . . fixhdr(C) 

chgrp: Changes group ID chgrp(C) 

chmod: Changes mode of a file. ...... chmod(S) 

environment, putenv: Changes or adds value to .... putenv(S) 

chown: Changes owner ID chown(C) 

nice: Changes priority of a process. . . nice(S) 

command, chroot: Changes root directory for .... chroot(ADM) 

modification dates of/ settime: Changes the access and settime(ADM) 

of a file or directory, chmod: Changes the access permissions . chmod(C) 

an SCCS delta, cdc: Changes the delta commentary of . cdc(CP) 

file, newform: Changes the format of a text . . . newform(C) 

system fsname: Prints or changes the name of a file .... fsname(ADM) 

file, chown: Changes the owner and group of a . chown(S) 

chroot: Changes the root directory. . . . chroot(S) 
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chsize: Qianges the size of a file chsize(S) 

chdir: Changes the woiking directory. . . chdir(S) 

cd: Changes woiking directory. . . . cd(C) 

list: list processor channel for MMDF list(ADM) 

process NIC database into channel/domain tables nictable: . nictable(ADM) 

xtproto: multiplexed channels protocol used by/ ... . xtproto(M) 

getch: Gets a character getch(DOS) 

getche: Gets and echoes a character getche(DOS) 

stream, ungetc: Pushes character back into input .... ungetc(S) 

isatty: Checks for a character device isatty(DOS) 

ioctl: Controls character devices ioctl(S) 

fgetc, fgetchar: Gets a character from a stream fgetc(DOS) 

getc, getchar, fgetc, getw: Gets character or word fix)m a stream. . getc(S) 

^utchar, fjputc, putw: Puts a character or word on a stream. . . putc(S) 

ascii: Map of the ASai character set ascii(M) 

trchan: lYanslate character sets trchan(M) 

fputc, Q)utchar: Write a character to a stream fputc(DOS) 

putch: Writes a character to the console putch(DOS) 

ungetch: Returns a character to the console buffer. . . ungetch(DOS) 

Displays/changes hard disk characteristics, dparam: dparam(ADM) 

Itoa: Converts long integers to characters Itoa(DOS) 

toascii: Qassifies or converts characters, /tolower, toupper, . . ctype(S) 

tolower, toascii: Translates characters, conv, toupper, .... conv(S) 

tr: Translates characters tr(C) 

ultoa: Converts numbers to characters ultoa(DOS) 

wc: Counts lines, words and characters wc(C) 

strrev: Reverses the order of characters in a string strrev(DOS) 

charater. strset: Sets all characters in a string to one . . . strset(DOS) 

strlwr: Converts uppercase characters to lowercase strlwr(DOS) 

strupr: Converts lowercase characters to uppercase strupr(DOS) 

characters in a string to one charater. strset: Sets all strset(DOS) 

lastlogin, monacct,/ acctsh: chargefee, ckpacct, dodisk, . . . acctsh(ADM) 

directory, chdir: Ciianges the woiking . . . chdir(S) 

non-obviousness, goodpw: Check a password for goodpw(ADM) 

fstab: File system mount and check commands fstab(F) 

Authentication database authck: check internal consistency of . . . authck(ADM) 

permissions file uucheck: check the uucp directories and . . uucheck(ADM) 

tcbck: trusted computing base checker tcbck(ADM) 

processed by fsck. checklist: List of file systems . . . checklist(F) 

has been submitted but not/ checkmail: checks for mail which . checkmail(C) 

report generator checkque: MMDF queue status . . checkque(ADM) 

waitsem, nbwaitsem: Awaits and checks access to a resource/ . . . waitsem(S) 

fsck: Checks and repairs file systems. . fsck(ADM) 

syntax, lint: Checks C language usage and . . lint(CP) 

isatty: Checks for a character device. . . isatty(DOS) 

submitted but not/ checkmail: checks for mail which has been . . checkmail(C) 

grpcheck: Checks group file grpcheck(C) 

pwcheck: Checks password file pwcheck(C) 

keystroke, kbhit: Checks the console for a .... kbhit(DOS) 

to be read, rdchk: Checks to see if there is data . . . rdchk(S) 



file, sum: Calculates checksum and counts blocks in a . sum(C) 
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auditing for the next session chg_audit: enables and disable . . chg_audit(ADM) 

chgrp: Changes group ID chgrp(0 

times: Gets process and child process times times(S) 

terminate, wait: Waits for a child process to stop or wait(S) 

chmod: Changes mode of a file. . . chmod(S) 

permissions of a file or/ chmod: Changes the access . . . chmod(C) 

chown: Changes owner ID. ... chown(C) 

group of a file, chown: Changes the owner and . . chown(S) 

for command, chroot: Changes root directory . . chroot(ADM) 

directory, chroot: Changes the root .... chroot(S) 

table chrtbl: create a ctype locale . . . chrtbl(M) 

file, chsize: Changes tiie size of a ... chsize(S) 

monacct,/ acctsh: chargefee, ckpacct, dodisk, lastlogin, .... acctsh(ADM) 

tolower, toupper, toascii: Qassifies or converts/ Aisascii, . . ctype(S) 

in directories specified cleantmp: remove temporary files . cleantmp(ADM) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

STREAMS error logger cleanup program strclean: .... strclean(ADM) 

clear: Clears a terminal screen. . . clear(C) 

stream status, ferror, feof, clearerr, fileno: Determines . . . ferror(S) 

clear: Clears a terminal screen clear(C) 

clri: Clears inode clri(ADM) 

a shell command interpreter with C-like syntax, csh: Invokes . . . csh(C) 

alarm: Sets a process' alarm clock alarm(S) 

gets string from real-time clock getclk: getclk(M) 

system real-time (time of day) clock, clock: The clock(F) 

system real-time (time of day) clock, setclock: Sets the .... setclock(ADM) 

rtc: real time clock interface rtc(HW) 

clock: Reports CPU time used. . . clock(S) 

(time of day) clock, clock: The system real-time . . . clock(F) 

operations, closedir: Performs directory . . . directory(S) 

close: Qoses a file descriptor. close(S) 

fclose, fflush: Qoses or flushes a stream fclose(S) 

shuts down the/ haltsys, reboot: Closes out the file systems and . . haltsys(ADM) 

fclose, fcloseall: Closes streams fclose(DOS) 

clri: Qears inode clri(ADM) 

size, cmchk: Reports hard disk block . . cmchk(C) 

configuration data base, cmos: Displays and sets the . . . cmos(HW) 

cmp: Compares two files cmp(C) 

coffconv: Convert 386 COFF files to XENIX format. . . co£6x)nv(M) 

col: Filters reverse linefeeds. . . . col(C) 

coltbl: create a coUation locale table coltbl(M) 

the audit/ auditd: read audit collection files generated by ... auditd(ADM) 

setcolor: Set screen color setcolor(C) 

screen: tty [0 1 -n] , color, monochrome, ega, screen(HW) 

locale table coltbl: create a collation coltbl(M) 

Ic: Lists directory contents in columns lc(C) 

comb: Combines sees deltas. . . comb(CP) 

comb: Combines SCCS deltas comb(CP) 

common to two sorted files, comm: Selects or rejects lines . . comm(C) 

Changes root directory for command, chroot: chroot(ADM) 

system: Executes a shell command. system(S) 
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time: Times a command time(CP) 

language ksh: standard command and programming . . . ksh(C) 

language rksh: restricted command and programming . . . ksh(Q 

nice: Runs a command at a different priority. . . nice(C) 

segread: command description segread(DOS) 

env: Sets environment for command execution env(C) 

quits. nohup:Runsa command immxme to hangups and . nohup(Q 

subsystem activationy auditcmd: command interface for audit . . . auditcmd(ADM) 

rsh: Invokes a restricted shell (command interpreter) rsh(C) 

sh: Invokes the shell command interpreter. sh(Q 

syntax, csh: Invokes a shell command interpreter with C-like . csh(C) 

uux: Executes command on remote XENIX. . . . uux(C) 

getopt: Parses command options getopt(C) 

getopts, getoptcvt - parse command options getopts: .... getopts(C) 

system activity timex: time a command; report process data and . timex(ADM) 

accounting records acctcms: command simmiary from per-process acctcms(ADM) 

File system mount and check commands, fstab: fstab(F) 

XENIX Development System commands, intro: Introduces . . . Intro(CP) 

and miscellaneous accounting commands /overview of accounting acct(ADM) 

help: Asks for help about SCCS commands help(CP) 

intro: Introduces XENIX commands Intro(C) 

xargs: Constmcts and executes commands xargs(C) 

at, batch: Executes commands at a later time at(C) 

cron: Executes commands at specified times. . . . cron(C) 

micnet: The Micnet default commands file. micnet(F) 

system, remote: Executes commands on a remote XENIX . . remote(C) 

environment rc2: run commands performed for multiuser rc2(ADM) 

operating system rcO: run commands performed to stop the . rcO(ADM) 

cdc: Changes the delta commentary of an SCCS delta. . . cdc(CP) 

line niunber entries in a common object file linenum: . . . linenum(F) 

relocation information for a common object file reloc: .... rcloc(F) 

scnhdr: section header for a common object file scnhdr(F) 

routines Idfcn: common object file access .... ldfcn(F) 

format syms: common object file symbol table . syms(F) 

filehdr: file header for common object files filehdr(F) 

comm: Selects or rejects lines common to two sorted files. . . . comm(0 

/the status of inter-process communication facilities ipcs(ADM) 

ftok: Standard interprocess communication package stdipc(S) 

cdrom: compact disk interface cdrom(HW) 

descriptions infocmp: compare or print out terminfo . . infocmp(ADM) 

dircmp: Compares directories dircmp(C) 

sdiff: Compares files side-by-side. . . . sdifB^C) 

diff. bdiffi Compares files too large for ... bdi£B[C) 

diskcp, diskcmp: Copies or compares floppy disks diskcp(C) 

diflB: Compares three files difiB(C) 

cmp: Compares two files cmp(C) 

diffi Compares two text files difiR^C) 

file, sccsdiff. Compares two versions of an SCCS sccsdifR^CP) 

regexp: Regular expression compile and match routines. . . . regexp(S) 

"terminfo: Format of ' compiled terminfo file. 

cc: Invokes the C compiler. cc(CP) 
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ticrTerminfo compiler tic(C) 

yacc: Invokes a compiler-compiler. yacc(CP) 

expressions, regex, regcmp: Compiles and executes regular . . regex(S) 

regcmp: Compiles regular expressions. . . regcmp(CP) 

erf, erfc: Error function and complementary error ftmction. . . erf(S) 

processes, wait: Awaits completion of background .... wait(C) 

subsystem: security subsystem component description subsystem(M) 

storage, compress: Compress data for ... compress(C) 

compress: Compress data for storage compress(C) 

pack, peat, unpack: Compresses and expands files. . . pack(Q 

scsi: Small computer systems interface. . . . scsi(HW) 

tcbck: trusted computing base checker .... tcbck(ADM) 

cat: Concatenates and displays files. . . cat(C) 

conditions, test: Tests test(Q 

system, config: Configures a XENIX . . . config(ADM) 

for/ strmtune: STREAMS configuration interface strmtune(ADM) 

update, or get device driver configuration data /add, delete, . . idinstall(ADM) 

cmos: Displays and sets the configuration data base cmos(HW) 

master EISA system kernel configuration file meisa(F) 

/line disciplines from kernel configuration files idaddld(ADM) 

hwconfig: Read the configuration information hwconfig(ADM) 

boards /UNIX kernel configuration manager for .... uconfig(ADM) 

strmcfg: STREAMS configuration utility strmcfg(ADM) 

upsconfig: UPS shutdown configuration utility upsconfig(ADM) 

pcu: configure ports pcu(ADM) 

boards uconfig: configure kernel for new .... uconfig(ADM) 

Anapscm, mapstr, convkey: Configure monitor screen/ .... mapkey(M) 

mapchan: Configure tty device mapping. . . mapchan(M) 

config: Configures a XENIX system. . . . config(ADM) 

spooling system. Ipadmin: Configures the lineprinter .... lpadmin(ADM) 

/fwtmp, wtmpfix: manipulate connect accounting records . . . fwtmp(ADM) 

an out-going terminal line connection, dial: Establishes . . . dial(S) 

database authck: check internal consistency of Authentication . . authck(ADM) 

cputs: Puts a string to the console cputs(DOS) 

putch: Writes a character to the console putch(DOS) 

to printer attached to a serial console /Print file consoleprint(ADM) 

Returns a character to the console buffer, ungetch: .... ungetch(DOS) 

console: System console device console(M) 

kbhit: Checks the console for a keystroke kbhit(DOS) 

cscanf: Converts and formats console input cscanf(DOS) 

messages: Description of system console messages messages(M) 

console: System console device. . console(M) 

printer attached to a serial/ consoleprint: Print file to .... consoleprint(ADM) 

for implementation-specific constants limits: file header . . . limits(IO 

math: math functions and constants math(M) 

unistd: file header for symbolic constants unistd(F) 

mkfs: Constructs a file system mkfs(ADM) 

commands, xargs: Constructs and executes xargs(C) 

debugging on uutry:tryto contact remote system with . . . uutry(ADM) 

idmkinit: read files containing specifications .... idmkinit(ADM) 

ev_block: Wait until the queue contains an event ev_block(S) 

I-ll 
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Ic: Lists directory contents in columns lc(C) 

Is: Gives information about contents of directories ls(Q 

1: Lists information about contents of directory 1(0 

Splits files according to context, csplit: csplit(C) 

uadmin: administrative control uadmin(ADM) 

uadmin: administrative control . uadmin(S) 

uucp status inquiry and job control, uustat: uustat(Q 

vc: version control vc(C) 

UUCP control files, uuinstall: Administers uuinstall(ADM) 

device tapecntl: AT&T t^ control for QIC-24/QIC-02 tape . . tapecnfl(C) 

init, inir: Process control initialization init(M) 

jagent: host control of windowing terminal . . jagent(M) 

msgctl: Provides message control operations msgctl(S) 

fcntl: file control options fcntl(M) 

cardjnfo: system tty controller card information file . . card_info 

ioctl: Controls character devices. . . . ioctl(S) 

fend: Controls open files fcntl(S) 

semctl: Controls semaphore operations. . . semctl(S) 

operations, shmctl: Controls shared memory .... shmctl(S) 

Translates characters, conv, toupper, tolower, toascii: . . conv(S) 

fcvt, gcvt: Performs output conversions, ecvt, ecvt(S) 

format, coffconv: Convert 386 COFF files to XENIX co£fconv(M) 

into a terminfo/ captoinfo: convert a termcap description . . captoinfo(ADM) 

double-precision/ strtod, atof: Converts a string to a strtod(S) 

UUCP routing/ uulist: converts a XENIX-style uulist(ADM) 

routing file to/ mnlist: converts a XENIX-style Micnet . . mnlist(ADM) 

dd: Converts and copies a file dd(C) 

input, cscanf: Converts and formats console . . cscanf(DOS) 

scanf, fscanf, sscanf: Converts and formats input. . . . scanf(S) 

libraries, ranlib: Converts archives to random . . . ranlib(CP) 

atof, atoi, atol: Converts ASCII to numbers. . . . atof(S) 

and long/ 13tol, ltol3: Converts between 3-byte integers . 13tol(S) 

and base 64 ASCII. a641, 164a: Converts between long integer . . a641(S) 

toupper, toascii: Qassifies or converts characters, /tolower, . . ctype(S) 

/gmtime, asctime, tzset: Converts date and time to ASCII. . ctime(S) 

characters. Itoa: Converts long integers to .... Itoa(DOS) 

uppercase, strupr: Converts lowercase characters to . strupr(DOS) 

ultoa: Converts numbers to characters. . ultoa(DOS) 

itoa: Converts numbers to integers. . . itoa(DOS) 

standard FORTRAN, ratfor: Converts Rational FORTRAN into ratfor(CP) 

strtol, atol, atoi: Converts string to integer. .... strtol(S) 

units: Converts units units(C) 

lowercase, strlwr: Converts uppercase characters to . strlwr(DOS) 

file to MMDF/ mmdfalias: converts XENIX-style aliases . . mmdfalias(ADM) 

screen/ mapkey, mapscm, mapstr, convkey: Configure monitor . . . mapkey(M) 

dd: Converts and copies a file dd(C) 

address, movedata: Copies bytes from a specific . . . movedata(DOS) 

cpio: Copies file archives in and out. . . cpio(C) 

cp: Copies files cp(C) 

systems, rep: Copies files across XENIX .... rcp(C) 

copy: Copies groups of files copy(C) 
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diskcp, diskcmp: Copies or compares floppy disks. . diskcp(C) 

Public XENIX-to-XENIX file copy, uuto.uupick: uuto(CO 

copy: Copies groups of files. . . . copy(C) 

volcopy: make literal copy of UNIX file system .... volcopy(ADM) 

for optimal access time dcopy: copy UNIX filesystems dcopy(ADM) 

core: Format of core image file. . . core(F) 

core: Format of core image file core(F) 

asktime: Prompts for the correct time of day asktime(ADM) 

atan2: Performs/ sin, cos, tan, asin, acos, atan, .... trig(S) 

functions, sinh, cosh, tanh: Performs hyperix)lic . . sinh(S) 

sum: Calculates checksimi and counts blocks in a file sum(Q 

characters, wc: Counts lines, words and wc(C) 

cp: Copies files cp(C) 

cpio: Format of cpio archive cpio(F) 

and out. cpio: Copies file archives in ... cpio(C) 

cpio: Format of cpio archive. . . . cpio(F) 

preprocessor, cpp: The C language cpp(CP) 

cprintf: Formats output cprintf(DOS) 

Flushes block I/O and halts the CPU. shutdn: shutdn(S) 

clock: Reports CPU time used clock(S) 

console, cputs: Puts a string to the .... cputs(DOS) 

crash: examine system images . . crash(ADM) 

rewrites an existing one. creat: Creates a new file or .... creat(S) 

vdutil: create a virtual disk vdutil(ADM) 

coltbl: create a collation locale table . . . coltbl(M) 

chrtbl: create a ctype locale table .... chrtbl(M) 

curtbl: create a currency locale table . . . curtbl(M) 

mestbl: create a messages locale file ... mestbl(M) 

numtbl: Create a numeric locale table. . . numtbl(M) 

file, tmpnam.tempnam: Creates a name for a temporary . . tmpnam(S) 

mkdir: Creates a new directory mkdir(DOS) 

an existing one. creat: Creates a new file or rewrites . . . creat(S) 

folk: Creates a new process foric(S) 

spawnl, spawnvp: Creates a new process spawn(DOS) 

ctags: Creates a tags file ctags(CP) 

tee: Creates a tee in a pipe tee(C) 

tmpfile: Creates a temporary file tmpfile(S) 

from C source, mkstr: Creates an error message file . . . mkstr(CP) 

profile, profil: Creates an execution time .... profil(S) 

semaphore, creatsem: Creates an instance of a binary . . creatsem(S) 

pipe: Creates an interprocess pipe. . . . pipe(S) 

files, admin: Creates and administers SCCS . . admin(CP) 

/Scans fixed disk for flaws and creates bad track table badtric(ADM) 

umask: Sets and gets file creation mask imiask(S) 

a binary semaphore, creatsem: Creates an instance of . creatsem(S) 

listing, cref: Makes a cross-reference . . cref(CP) 

atcronsh: Menu driven at and cron administration utility .... atcronsh(ADM) 

specified times, cron: Executes commands at . . . cron(Q 

"crontab: user" "crontab file" 

"crontab: user crontab 

intro: Introduction to DOS cross development fimctions. . . . intro(DOS) 



1-13 



Permuted Index 



dosld: XENIX to MS-DOS cross linker. dosld(CP) 

cxref: Generates C program cross-reference cxref(CP) 

cref: Makes a cross-reference listing cref(CP) 

xrcf: Cross-references C programs. . . xrcf(CP) 

crypt: encode/decode crypt(C) 

console input, cscanf: Converts and formats . . . cscanf(DOS) 

interpreter with C-like syntax, csh: Invokes a shell command . . csh(C) 

to context, csplit: Splits files according . . . csplit(C) 

terminal ct: spawn getty to a remote . . . ct(C) 

ctags: Creates a tags file ctags(CP) 

for a terminal, ctennid: Generates a filename . . ctermid(S) 

asctime, tzset: Converts date/ ctime, localtime, gmtime, .... ctime(S) 

islower, isdigit, isxdigity ctype, isalpha, isupper, ctype(S) 

chrtbl: create a ctype locale table chrtbl(M) 

cu: Calls another XENIX system. . cu(C) 

curtbl: create a currency locale table curtbl(M) 

ev_getemask: Return the current event mask ev_gtemsk(S) 

rename login entry to show current layer relogin: ...... relogin(ADM) 

pointer, tell: Gets the current position of the file .... tell(DOS) 

activity, sact: Prints current SCCS file editing .... sact(CP) 

the slot in the utmp file of the current user, ttyslot: Finds .... ttyslot(S) 

getcwd: Get the pathname of current working directory getcwd(S) 

uname: Gets name of current XENIX system uname(S) 

uname: Prints the name of the current XENIX system uname(C) 

/Returns the number of events currently in the queue ev_count(S) 

ev_flush: Discard all events currently in the queue ev_flush(S) 

/displays the list of vectors currently specified in the/ .... vectorsinuse(ADM) 

/the list of major device numbers currently specified in the/ .... majorsinuse(ADM) 

cursor fimctions. curses: Performs screen and . . . curses(S) 

scr_dump: format of curses screen image file scr_dump(F) 

curses: Performs screen and cursor functions curses(S) 

table curtbl: create a currency locale . . curtbl(M) 

spline: Interpolates smooth curve spline(CP) 

the user, cuserid: Gets the login name of . . cuserid(S) 

each line of a file, cut: Cuts out selected fields of . . cut(C) 

line of a file, cut: Cuts out selected fields of each . . cut(C) 

cross-reference, cxref: Generates C program . . . cxref(CP) 

STREAMS error logger daemon strerr: strerr(ADM) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

vddaemon: virtual disk daemon vddaemon(ADM) 

daemoamn: Micnet mailer daemon. daemon.mn(M) 

runacct: run daily accounting runacct(ADM) 

- handle special functions of DASI 300 and 300s/ /300s .... 300(C) 

handle special functions of the DASI 450 terminal 450: 450(Q 

get device driver configuration data /add, delete, update, or ... idinstall(ADM) 

prof: Displays profile data prof(CP) 

sdwaitv: Synchronizes shared data access, sdgetv, sdgetv(S) 

reduce: perform audit data analysis and reduction . . . reduce(ADM) 

time a command; report process data and system activity timex: . . timex(ADM) 

and sets the configuration data base, cmos: Displays .... cmos(HW) 

termcap: Terminal capability database termcap(M) 



1-14 



Permuted Index 



"terminfo: terminal capability" database. 

generate disk accounting data by user ID diskusg: .... diskusg(ADM) 

compress: Compress data for storage compress(C) 

bricctl: Allocates data in a far segment bikctl(S) 

/sgetl: Accesses long integer data in a machine-independent. . . sputl(S) 

plock: Lock process, text, or data in memory plock(S) 

execseg: makes a data region executable execseg(S) 

call. Stat: Data returned by stat system . . . stat(F) 

Attaches and detaches a shared data segment, sdget, sdfree: . . . sdget(S) 

Synchronizes access to a shared data segment, sdenter, sdleave: . . sdenter(S) 

sbik, biic: Changes data segment space allocation. . . sbik(S) 

rdchk: Checks to see if there is data to be read rdchk(S) 

types: Primitive system datatypes types(F) 

authcap: authentication database authcap(ADM) 

consistency of Authentication database authck: check internal . authck(ADM) 

files against authenticiation database /examine system .... integrity(ADM) 

"terminfo: terminal description" database. 

tput: Queries the terminfo database tput(C) 

isverify: verifies ISAM database entries isverify(M) 

backups schedule: Database for automated system . . schedule(ADM) 

firstkey, nextkey: Performs database functions, /delete, . . . dbm(S) 

tables nictable: process NIC database into channel/domain . . nictable(ADM) 

/builds the MMDF hashed database of alias and routing/ . . . dbmbuild(ADM) 

date: Prints and sets the date date(Q 

time, ftime: Gets time and date time(S) 

/gmtime, asctime, tzset: Converts date and time to ASCII ctime(S) 

date: Prints and sets the date. . . . date(C) 

sddate: Prints and sets backup dates sddate(C) 

the access and modification dates of files. /Changes settime(ADM) 

strftime: format date/time string strftime(S) 

Prompts for the correct time of day. asktime: asktime(ADM) 

The system real-time (time of day) clock, clock: clock(F) 

the system real-time (time of day) clock, setclock: Sets .... setclock(ADM) 

MMDF hashed database of/ dbmbuild: builds the dbmbuild(ADM) 

firstkey, nextkey: Performs/ dbminit, fetch, store, delete, . . . dbm(S) 

precision calculator, dc: Invokes an arbitrary dc(C) 

filesystems for optimal access/ dcopy: copy UNIX dcopy(ADM) 

dd: Converts and copies a file. . . dd(C) 

devices, assign, deassign: Assigns and deassigns . assign(0 

assign, deassign: Assigns and deassigns devices assign(Q 

adb: Invokes a general-purpose debugger adb(CP) 

fsdb: File system debugger fsdb(ADM) 

sdb: Invokes symbolic debugger. sdb(CP) 

to contact remote system with debugging on uutry: try uutry(ADM) 

transmission via mail uudecode: decode a binary file for uuencode(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

micnet: The Micnet default commands file micnet(F) 

information directory, default: Default program .... default(F) 

defopen, defread: Reads default entries defopen(S) 

directory, default: Default program information . . . default(F) 

timezone: set default system time zone .... tiinezone(F) 
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entries, defopen, defread: Reads default . . defopen(S) 

defopen, defread: Reads default entries. . . defopen(S) 

del.vd: delete a virtual disk del.vd(ADM) 

Performs/ dbminit, fetch, store, delete, firstkey, nextkey: .... dbm(S) 

driver/ idinstall: add, delete, update, or get device . . . idinstall(ADM) 

rmdir: Deletes a directory . nndir(DOS) 

process deliver: MMDF mail delivery . . deliver(ADM) 

which has been submitted but not delivered /checks for mail .... checkmail(Q 

pathname, dimame: Delivers directory part of .... dimame(C) 

file, tail: Delivers the last part of a .... tail(Q 

maildelivery: user mail delivery specification file .... maildelivery(F) 

deliver: MMDF mail delivery process deliver(ADM) 

the delta commentary of an sees delta, cdc: Changes cdc(CP) 

delta: Makes a delta (change) to an SCCS file. . . delta(CP) 

delta, cdc: Changes the delta commentary of an SCCS . . cdc(CP) 

rmdel: Removes a delta from an SCCS file nndel(CP) 

an SCCS file, delta: Makes a delta (change) to . delta(CP) 

comb: Combines SCCS deltas comb(CP) 

terminal, mesg: Permits or denies messages sent to a .... mesg(C) 

description into a terminfo description /convert a termcap . . captoinfo(ADM) 

security subsystem component description subsystem: subsystem(M) 

segread: command description segread(DOS) 

"terminfo: terminal" description database. . . 

captoinfo: convert a termcap description into a terminfo/ . . . captoinfo(ADM) 

messages, messages: Description of system console . . messages(M) 

compare or print out terminfo descriptions infocmp: infocmp(ADM) 

close: Closes a file descriptor close(S) 

dup2: Duplicates an open file descriptor, dup dup(S) 

sdget, sdfree: Attaches and detaches a shared data segment. . sdget(S) 

fstyp: determine file system identifier . . fstyp(ADM) 

file, access: Determines accessibility of a ... access(S) 

dtype: Determines disk type dtype(C) 

eof: Determines end-of-file eof(DOS) 

hypot, cabs: Determines Euclidean distance. . . hypot(S) 

file: Determines file type file(C) 

ferror, feof, clearerr, fileno: Determines stream status ferror(S) 

whodo: Determines who is doing what. . . whodo(C) 

audit: audit subsystem interface device audit(ADM) 

console: System console device console(M) 

control for QIC-24/QIC-02 tape device tapecnd: AT&T tape . . . tapecntl(C) 

error: Kernel error output device error(M) 

font and video mode for a video device, vidi: Sets the vidi(C) 

isatty: Checks for a character device isatty(DOS) 

systty: System maintenance device systty(M) 

/add, delete, update, or get device driver configuration data . . idinstaU(ADM) 

/Default backup device information archive(F) 

scsinfo: display current SCSI device information scsinfo(ADM) 

Ip, IpO, Ipl , lp2: Line printer device interfaces lp(HW) 

mapchan: Configure tty device mapping mapchan(M) 

mapchan: Format of tty device mapping files mapchan(F) 

devnm: Identifies device name devnm(C) 
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/displaying and removing hard disk device names hdutil(ADM) 

current SCSI hard disks /display device names Getters) for .... scsinfo(ADM) 

/displays the list of major device numbers currently/ .... majorsinuse(ADM) 

disks /display major and minor device numbers for current SCSI . scsinfo(ADM) 

deassign: Assigns and deassigns devices, assign, assign(Q 

event queue and all associated devices. ev_close: Close the . . . ev_close(S) 

ioctl: Controls character devices ioctl(S) 

ev_getdev: Gets a list of devices feeding an event queue. . ev_getdev(S) 

devices: Format of UUCP devices file devices(F) 

ev_gindev: include/exclude devices for event input ev_gindev(S) 

file, devices: Format of UUCP devices . devices(F) 

devnm: Identifies device name. . . devnm(C) 

blocks, df: Report number of free disk . . df(C) 

dial: Dials a modem dial(ADM) 

terminal line connection, dial: Establishes an out-going . . dial(S) 

dialcodes: Format of UUCP dial-code abbreviations file. . . . dialcodes(F) 

dial-code abbreviations file, dialcodes: Format of UUCP . . . dialcodes(F) 

dialers: Format of UUCP Dialers file dialers(F) 

file, dialers: Format of UUCP Dialers . dialers(F) 

dial: Dials a modem dial(ADM) 

uuchat: dials a modem dial(ADM) 

passwd: Change login, group, or dialup shell password passwd(C) 

Compares files too large for dff. bdilf. bdifiB^C) 

difE Compares two text files. . . . difiR^C) 

difB: Compares three files. . . . difiB(C) 

dir: Format of a directory dir(F) 

dircmp: Compares directories. . . dircmp(C) 

dircmp: Compares directories dircmp(C) 

information about contents of directories. Is: Gives ls(Q 

link and unlink files and directories link: link, unlink: . . . link(ADM) 

mv: Moves or renames files and directories . mv(Q 

rm, rmdir: Removes files or directories rm(C) 

rmdir: Removes directories rmdir(C) 

uucheck: check the uucp directories and permissions file . . uucheck(ADM) 

remove temporary files in directories specified cleantmp: . . cleantmp(ADM) 

Default program infomiation directory, default: default(F) 

access permissions of a file or directory, chmod: Changes the . . chmod(C) 

cd: Changes woricing directory cd(C) 

chdir: Changes the woricing directory chdir(S) 

chroot: Changes the root directory chroot(S) 

dir: Format of a directory dir(F) 

information about contents of directory. 1: Lists 1(C) 

mkdir: Creates a new directory. . mkdir(DOS) 

mkdir: Makes a directory mkdir(Q 

mvdir:Movesa directory mvdir(C) 

rename: renames a file or directory. rename(DOS) 

rmdir: Deletes a directory nndir(DOS) 

the pathname of current woricing directory, getcwd: Get getcwd(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

Ic: Lists directory contents in columns. . . lc(C) 

file, getdents: read directory entries and put in a ... getdents(S) 
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dirent: file system independent directory entry dirent(F) 

dirent: file-system-independent directory entry dirent(F) 

unlink: Removes directory entry unlink(S) 

chroot: Changes root directory for command chroot(ADM) 

uucico: Scan the spool directory for woric uucico(C) 

pwd: Prints woridng directory name pwd(C) 

basename: Removes directory names from pathnames. . basename(Q 

closedir: Performs directory operations directory(S) 

ordinary file, mknod: Makes a directory, or a special or mknod(S) 

dimame: Delivers directory part of pathname. . . . dimame(C) 

directory entry, dirent: file system independent . . dircnt(F) 

directory entry dirent: file-system-independent . . dirent(F) 

of pathname, dimame: Delivers directory part . dimame(C) 

session chg_audit: enables and disable auditing for the next . . . chg_audit(ADM) 

printers, disable: TXims off terminals and . . disable(C) 

acct: Enables or disables process accounting. . . . acct(S) 

the queue. ev_flush: Discard all events currently in . . ev_flush(S) 

type, modes, speed, and line discipline /set terminal uugetty(ADM) 

type, modes, speed, and line discipline. /Sets terminal .... getty(M) 

add.vd: add a virtual disk add.vd(ADM) 

cdrom: compact disk interface cdrom(HW) 

vdinfo: display virtual disk information vdinfo(ADM) 

diskusg: generate disk accounting data by user ID . . diskusg(ADM) 

cmchk: Reports hard disk block size cmchk(C) 

df: Report number of free disk blocks df(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

/displaying and removing hard disk device names hdutil(ADM) 

hd: Internal hard disk drive hd(HW) 

track/ badtik: Scans fixed disk for flaws and creates bad . . badtik(ADM) 

vddaemon: virtual disk initialization vddaemon(ADM) 

and size/ display hard disk partition, division, dlayout(ADM) 

fdisk: Maintain disk partitions fdisk(ADM) 

dtype: Determines disk type dtype(C) 

du: Summarizes disk usage du(C) 

and removing/ hdutil: hard disk utility for displaying .... hdutil(ADM) 

floppy disks, diskcp, diskcmp: Copies or compares . . diskcp(0 

compares floppy disks, diskcp, diskcmp: Copies or ... diskcp(Q 

Copies or compares floppy disks, diskcp, diskcmp: diskcp(Q 

format: format floppy disks format(C) 

accounting data by user ID diskusg: generate disk diskusg(ADM) 

lunoxmt: Dismounts a file structure umount(ADM) 

majorAninor numbers display specific hard disk .... hdutil(ADM) 

zcat: Display a stored file compress(C) 

for a mirrored disk vdutil: display bad blocks vdutil(ADM) 

information scsinfo: display current SCSI device . . . scsinfo(ADM) 

vedit: Invokes a screen-oriented display editor, vi, view, vi(C) 

division, and size/ display hard disk partition, .... dlayout(ADM) 

displaypkg: display installed packages .... displaypkg(ADM) 

vdinfo: display virtual disk information . vdinfo(ADM) 

specific hard disk names/ displaying and removing .... hdutil(ADM) 

packages displaypkg: display installed . . . displaypkg(ADM) 



1-18 



Permuted Index 



configuration data base, cmos: Displays and sets the cmos(HW) 

cat: Concatenates and displays files cat(C) 

fonnat. hd: Displays files in hexadecimal . . . hd(C) 

od: Displays files in octal fonnat. . . . od(C) 

system activity, uptime: Displays information about . . . uptime(0 

is on the system and what w: Displays information about who . w(C) 

prof: Displays profile data prof(CP) 

executable binary files, hdr: Displays selected parts of .... hdr(CP) 

device numbers/ majorsinuse: displays the list of major .... majorsinuse(ADM) 

currently/ vectorsinuse: displays the list of vectors .... vectorsinuse(ADM) 

characteristics, dparam: Displays/changes hard disk . . . dparam(ADM) 

mail: Sends, reads or disposes of mail mail(Q 

cabs: Determines Euclidean distance, hypot hypot(S) 

lcong48: Generates uniformly distributed. srand48, seed48, . . . drand48(S) 

disk partition, division, and size information . . dlayout(ADM) 

divvy -b block_device -c c/ . . diwy(ADM) 

records for subsystem events dlvr_audit: produce audit .... dlvr_audit(ADM) 

object downloader for the 5620 DMD terminal wtinit: wtinit(ADM) 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct,/ . . . acctsh(ADM) 

whodo: Determines who is doing what whodo(C) 

promain: restrict the execution domain of a program promain(M) 

Intro: Introduction to DOS cross development functions. intro(DOS) 

dosexterr: Gets DOS error messages dosexter(DOS) 

dosls, dosrm, dosmidir: Access DOS files dos(C) 

bdos: Invokes a DOS system call bdos(DOS) 

intdos: Invokes a DOS system caU intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

messages, dosexterr: Gets DOS error .... dosexter(DOS) 

linker, dosld: XENIX to MS-DOS cross . dosld(CP) 

DOS files, dosls, dosrm, dosrmdir: Access . . dos(Q 

files, dosls, dosrm, dosrmdir: Access DOS . . dos(Q 

dosls, dosrm, dosrmdir: Access DOS files. . . . dos(C) 

/atof: Converts a string to a double-precision number strtod(S) 

DMD/ wtinit: object downloader for the 5620 .... wtinit(ADM) 

disk characteristics, dparam: Displays/changes hard . . dparam(ADM) 

graph: draw a graph graph(ADM) 

Swaps default boot floppy drive, fdswap: fdswap(ADM) 

hd: Internal hard disk drive hd(HW) 

administration/ atcronsh: Menu driven at and cron atcronsh(ADM) 

utility auditsh: Menu driven audit administration . . . auditsh(ADM) 

utility backupsh: Menu driven backup administration . . . backupsh(ADM) 

administration/ Ipsh: Menu driven Ip print service Ipsh(ADM) 

utility, sysadmsh: Menu driven system administration . . . sysadmsh(ADM) 

protocol used by x t (7) driver Anultiplexed channels . . . xtproto(M) 

sxt: Pseudo-device driver sxt(M) 

delete, update, or get device driver configuration data /add, . . idinstall(ADM) 

object module, routines: finds driver entry points in a driver . . . routines(ADM) 

terminals xt: multiplexed tty driver for AT&T windowing . . . xt(HW) 

finds driver entry points in a driver object module, routines: . . routines(ADM) 

xtt: extract and print xt driver packet traces xtt(ADM) 

xts: extract and print xt driver statistics xts(ADM) 
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term: Terminal driving tables for nroft tenn(F) 

dtype: Determines disk type. . . . dtype(C) 

du: Summarizes disk usage. . . . du(C) 

backup: Incremental dump tape format backup(F) 

files on a backup archive, dumpdir: Prints the names of . . . dumpdir(C) 

file, tapedump: Dumps magnetic tape to output . . tapedump(C) 

file descriptor, dup, dup2: Duplicates an open . . dup(S) 

descriptor, dup, dup2: Duplicates an open file . . . dup(S) 

descriptor, dup, dup2: Duplicates an open file dup(S) 

echo: Echoes arguments echo(Q 

getche: Gets and echoes a character. getche(DOS) 

echo: Echoes arguments echo(Q 

output conversions, ecvt, fcvt, gcvt: Performs .... ecvt(S) 

ed: Invokes the text editor. .... ed(C) 

program, end, etext, edata: Last locations in end(S) 

for casual users) edit: text editor (variant of ex . . . edit(Q 

sact: Prints current SCCS file editing activity sact(CP) 

a screen-oriented display editor, /view, vedit: Invokes . . . vi(Q 

ed: Invokes the text editor. ed(C) 

ex: Invokes a text editor. ex(C) 

Id: Invokes the link editor Id(CP) 

Id: Invokes the link editor ld(M) 

Format of assembler and link editor output. a.out: a.out(F) 

the stream editor, sed: Invokes sed(C) 

users) edit: text editor (variant of ex for casual . . edit(C) 

effective user, real group, and effective group IDs. /real user, . . getuid(S) 

/getgid, getegid: Gets real user, effective user, real group, and/ . . getuid(S) 

color, monochrome, ega,. /tty[01-n] screen(HW) 

for a pattern, grep, egrep, fgrep: Searches a file ... grep(C) 

filemeisa: master EISA system kernel configuration . meisa(F) 

i286emul: emulate 80286 i286emul(C) 

x286emul: emulate XENIX 80286 x286emul(Q 

line printers, enable: TXims on terminals and . . enable(C) 

the next session chg_audit: enables and disable auditing for . . chg_audit(ADM) 

accounting, acct: Enables or disables process . . . acct(S) 

transmission via mail uuencode: encode a binary file for uuencode(C) 

crypt: encode/decode crypt(C) 

makekey: Generates an encryption key makekey(M) 

locations in program, end, etext, edata: Last end(S) 

, /getgrgid, getgmam, setgrent, endgrent: Get group file entry. . . getgrent(S) 

eof: Determines end-of-file eof(DOS) 

/getpwuid, getpwnam, setpwent, endpwent: Gets password file/ . . getpwent(S) 

utmp file entry, endutent, utmpname: Accesses . . getut(S) 

submit: MMDF mail enqueuer submit(ADM) 

defopen, defrcad: Reads default entries defopen(S) 

wtmp: Formats of utmp and wtmp entries, utmp, utmp(F) 

getdents: read directory entries and put in a file getdents(S) 

xlist, fxlist: Gets name list entries from files xlist(S) 

nlist: Gets entries from name list nlist(S) 

linenum: line number entries in a common object file . . linenum(F) 

directory entry /file-system-independent . . dirent(F) 
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endgrent: Get group file entry, /getgmam, setgrent, .... getgrent(S) 

endpwent: Gets password file entry, /getpwnam, setpwent, . . . getpwent(S) 

putpwent: Writes a password file entry putpwent(S) 

system independent directory entry, dirent: file dirent(F) 

unlink: Removes directory entry unlink:(S) 

utmpname: Accesses utmp file entry, endutent getut(S) 

module, routines: finds driver entry points in a driver object . . routines(ADM) 

relogin: rename login entry to show current layer .... relogin(ADM) 

command execution, env: Sets envirorunent for .... env(C) 

environ: The user environment. . . environ(M) 

Set or read international environment setlocale: setlocale(S) 

commands performed for multiuser environment rc2: run rc2(ADM) 

environ: The user environment environ(M) 

putenv: Changes or adds value to environment putenv(S) 

profile: Sets up an environment at login time profile(M) 

execution, env: Sets environment for command .... env(C) 

getenv: Gets value for environment name getenv(S) 

TZ: Time zone environment variable tz(M) 

eof: Determines end-of-file. . . . eof(DOS) 

complementary error function, erf, erfc: Error function and . . . erf(S) 

complementary error/ erf, erfc: Error function and erf(S) 

perror, sys_errlist, sys_nerr, ermo: Sends system error/ .... perror(S) 

Error function and complementary error function, erf, erfc: erf(S) 

error function, erf, erfc: Error function and complementary erf(S) 

device, error: Kernel error output .... error(M) 

strclean: STREAMS errorlogger cleanup program . . . strclean(ADM) 

strerr: STREAMS error logger daemon strerr(ADM) 

source, mkstr: Creates an error message file from C .... mkstr(CP) 

dosexterr: Gets DOS error messages dosexter(DOS) 

sys_nerr, ermo: Sends system error messages. /sys_errlist, . . . perror(S) 

services, library routines and error numbers, /system Intro(S) 

error: Kernel error output device error(M) 

fsave: Interactive, error-checking filesystem backup . fsave(ADM) 

matherr: Error-handling function matherr(S) 

hashcheck: Finds spelling errors, /hashmake, speUin spell(Q 

terminal line connection, dial: Establishes an out-going .... dial(S) 

setmnt: Establishes /etc/mnttab table. . . . setmnt(ADM) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

program, end, etext, edata: Last locations in . . . end(S) 

hypot, cabs: Determines Euclidean distance hypot(S) 

expression, expr: Evaluates arguments as an .... expr(Q 

contains an event ev_block: Wait until the queue . . ev_block(S) 

and all associated devices. ev_close: Close the event queue . ev_close(S) 

events currently in the queue. ev_count: Returns the number of . ev_count(S) 

Wait until the queue contains an event. ev_block: ev_block(S) 

ev_read: Read the next event in the queue ev_read(S) 

include/exclude devices for event input. ev_gindev: ev_gindev(S) 

evjnit: Invokes the event manager. ev_init(S) 

ev_getemask: Return the current event mask ev_gtemsk(S) 

ev_setemask: Sets event mask ev_stemsk(S) 

ev_pop: Pop the next event off the queue ev_pop(S) 
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a list of devices feeding an event queue. ev_getdev: Gets . . ev_getdev(S) 

ev_suspend: Suspends an event queue ev_susp(S) 

devices. ev_close: Qose the event queue and all associated . . ev_close(S) 

ev_open: Opens an event queue for input ev_open(S) 

audit records for subsystem events dlvr_audit: produce . . . dlvr_audit(ADM) 

ev_count: Returns the number of events currently in the queue. . . ev_count(S) 

ev_flush: Discard all events currently in the queue. . . ev_flush(S) 

currently in the queue. ev_flush: Discard all events . . . ev_flush(S) 

devices feeding an event queue. ev_getdev: Gets a list of ev_getdev(S) 

event mask. ev_getemask: Return the current . ev _gtemsk(S) 

devices for event input. ev_gindev: include/exclude . . . ev_gindev(S) 

manager, evjnit: Invokes the event .... ev_init(S) 

for input. ev_open: Opens an event queue . . ev_open(S) 

the queue. ev_pop: Pop the next event off . . ev_pop(S) 

the queue. ev_read: Read the next event in . . ev_read(S) 

queue. ev_resume: Restart a suspended . ev_resume(S) 

ev_setemask: Sets event mask. . . ev_stemsk(S) 

queue. ev_suspend: Suspends an event . . ev_susp(S) 

edit: text editor (variant of ex for casual users) edit(C) 

ex: Invokes a text editor. .... ex(C) 

authentication/ integrity: examine system files against . . . integrity(ADM) 

crash: examine system images crash(ADM) 

pax: portable archive exchange pax(C) 

execlp, execvp: Executes a/ execl, execv, execle, execve, . . . exec(S) 

Executes a file, execl, execv, execle, execve, execlp, execvp: . . exec(S) 

execl, execv, execle, execve, execlp, execvp: Executes a file. . . exec(S) 

executable, execseg: makes a data region . . . execseg(S) 

execseg: makes a data region executable execseg(S) 

fixhdr: Changes executable binary file headers. . . fixhdr(C) 

hdr: Displays selected parts of executable binary files hdr(CP) 

execle, execve, execlp, execvp: Executes a file, execl, execv, . . exec(S) 

system: Executes a shell command. . . . system(S) 

int86: Executes an interrupt int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

XENIX, uux: Executes command on remote . . uux(Q 

xargs: Constructs and executes commands xargs(C) 

time, at, batch: Executes commands at a later . . at(C) 

times, cron: Executes commands at specified . cron(C) 

XENIX system, remote: Executes commands on a remote . remote(C) 

regex, regcmp; Compiles and executes regular expressions. . . . regex(S) 

Sets environment for command execution, env: env(C) 

promain: restrict the execution domain of a program . . promain(M) 

nap: Suspends execution for a short interval. . . nap(S) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 

monitor: Prepares execution profile monitor(S) 

profil: Creates an execution time profile profil(S) 

execvp: Executes a file, execl, execv, execle, execve, execlp, . . exec(S) 
a file, execl, execv, execle, execve, execlp, execvp: Executes . exec(S) 
execv, execle, execve, execlp, execvp: Executes a file, execl, . . exec(S) 
link: Links a new filename to an existing file link(S) 
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a new file or rewrites an existing one. creat: Creates . . . creat(S) 

process, exit, _exit: Terminates a exit(S) 

exit, _exit: Terminates a process. . . . exit(S) 

process, exit: Terminates the calling . . . exit(DOS) 

false: Returns with a nonzero exit value false(0 

true: Returns with a zero exit value true(C) 

Performs exponentiaiy exp, log, pow, sqrt, loglO: .... exp(S) 

peat, unpack: Compresses and expands files, pack, pack(Q 

number into a mantissa and an exponent. /Splits floating-point . . fiexp(S) 

Aog, pow, sqrt, loglO: Performs exponential, logarithm, powery . . exp(S) 

expression, expn Evaluates arguments as an . expr(Q 

expr: Evaluates arguments as an expression expr(Q 

routines, regexp: Regular expression compile and match . . regexp(S) 

Compiles and executes regular expressions, regex, regcmp: . . . regex(S) 

regcmp: Compiles regular expressions regcmp(CP) 

rmb: remove extra blank lines from a file . . . rmb(M) 

packet traces xtt: exti-act and print xt driver .... xtt(ADM) 

statistics xts: extract and print xt driver .... xts(ADM) 

programs, xstr: Extracts strings from C xstr(CP) 

absolute value, floor^ floor, fabs, ceil, fmod: Performs .... floor(S) 

of inter-process communication facilities. /Reports the status . . . ipcs(ADM) 

factor: Factor a number factor(C) 

factor: Factor a number. factor(C) 

powerfail: performs power faUure shutdown service .... powerfail(M) 

restart: performs power failure recovery service restart(M) 

exit value, false: Returns with a nonzero . . . false(Q 

abort: Generates an lOT fault abort(S) 

currently specified in the sdevice file /of vectors vectorsinuse(ADM) 

streams, fclose, fcloseall: Qoses fclose(DOS) 

flushes a stream, fclose, fflush: Closes or fclose(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

fcntl: Controls open files fcntl(S) 

fcntl: file control options .... fcntl(M) 

conversions, ecvt, fcvt, gcvt: Performs output .... ecvt(S) 

fdisk: Maintain disk partitions. . . fdisk(ADM) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

floppy drive, fdswap: Swaps default boot . . . fdswap(ADM) 

/to machine related miscellaneous features and files hitro(HW) 

Introduction to miscellaneous features and files, intro: Intro(M) 

/Gets a list of devices feeding an event queue ev_getdev(S) 

Determines stream/ ferror, feof, clearerr, fileno: ferror(S) 

Determines stream status, ferror, feof, clearerr, fileno: . . . ferror(S) 

nextkey: Performs/ dbminit, fetch, store, delete, firstkey, . . . dbm(S) 

stream, fclose, flhish: Closes or flushes a .... fclose(S) 

character from a stream, fgetc, fgetchar: Gets a fgetc(DOS) 

word from a/ getc, getchar, fgetc, getw: Gets character or . . getc(S) 

a stream, fgetc, fgetchar: Gets a character from . . fgetc(DOS) 

stream, gets, fgets: Gets a string from a .... gets(S) 

pattern, grep, egrep, fgrep: Searches a file for a .... grep(C) 

cut: Cuts out selected fields of each line of a file cut(C) 

Alternative login terminals file, inittab: inittab(F) 
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Changes the format of a text file, newform: newform(Q 

Changes the owner and group of a file, chown: chown(S) 

Compares two versions of an sees file. sccsdifE sccsdifB^CP) 

Creates a name for a temporary file, tmpnam, tempnam: ..... tmpnam(S) 

Delivers the last part of a file, tail: tail(C) 

Determines accessibility of a file, access: access(S) 

Dumps magnetic tape to output file, tapedimip: tapedump(C) 

Format of UUCP Permissions file, permissions: permissions(F) 

Format of UUCP Sysfiles file, sysfiles: sysfiles(F) 

Format of compiled terminfo file, "terminfo:" terminfo(F) 

Format of per-process accounting file, acct: acct(FO 

Prints the size of an object file, size: size(CP) 

Removes a delta from an sees file, rmdel: rmdel(CP) 

Reports repeated lines in a file, imiq: uniq(Q 

The Micnet default commands file, micnet: micnet(F) 

The Micnet system identification file, systemid: systemid(F) 

UUCP MJ«c/igd limit file, maxuuscheds: maxuuscheds(F) 

UUCP Mwx^Himit file, maxuuxqts: maxuuxqts(F) 

Undoes a previous get of an sees file, unget: imget(CP) 

a delta (change) to an sees file, delta: Makes deltaCCP) 

a new filename to an existing file, link: Links link(S) 

and modification times of a file, touch: Updates access . . . touch(Q 

checksum and counts blocks in a file, sum: Calculates sum(C) 

chmod: Changes mode of a file chmod(S) 

chsize: Changes the size of a file chsize(S) 

core: Format of core image file core(F) 

"crontab: user crontab" file 

ctags: Creates a tags file ctags(CP) 

dd: Converts and copies a file dd(C) 

devices: Format of UUCP devices file devices(F) 

dialers: Format of UUCP Dialers file dialers(F) 

directory entries and put in a file, getdents: read getdents(S) 

entries in a common object file linenum: line number .... linenum(F) 

execlp, execvp: Executes a file, /execv, execle, execve, . . . exec(S) 

fields of each line of a file, cut: Cuts out selected .... cut(C) 

fllelength: Gets the length of a file fileleng(DOS) 

for and processes a pattern in a file, awk: Searches awk(Q 

format of curses screen image file. scr_dump: scr_dump(F) 

group: Format of the group file group(M) 

grpcheck: Checks group file grpcheck(C) 

header for a common object file scnhdr: section scnhdr(F) 

information for a common object file reloc: relocation reloc(F) 

issue: issue identification file issue(F) 

hi: Makes a link to a file ln(C) 

mem, kmem: Memory image file mem(M) 

mestbl: create a messages locate file mestbl(M) 

nl: Adds line numbers to a file nl(Q 

nuU: The null file nuU(F) 

of UUCP dial-code abbreviations file, dialcodes: Format dialcodes(F) 

or a special or ordinary file, mknod: Makes a directory, . . mknod(S) 

passwd: The password file passwd(F) 
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poll: Fomat of UUCP Poll file poll(F) 

printable strings in an object file, strings: Finds the strings(CP) 

pre: Prints an sees file pre(CP) 

pwcheck: Checks password file pwcheck(C) 

read: Reads from a file read(S) 

remove extra blank lines from a file rmb: rmb(M) 

sccsfile: Format of an SCCS file sccsfile(F) 

specified in the sdevice file /fist of vectors currently . . . vectorsinuse(ADM) 

specified in the mdevice file /device numbers currently . . majoreinuse(ADM) 

systems: Format of UUCP Systems file systems(F) 

tmpfile: Creates a temporary file tmpfile(S) 

uncompress: Uncompress a stored file compress(C) 

uucp directories and permissions file uucheck: check the uucheck(ADM) 

val: Validates an SCCS file val(CP) 

write: Writes to a file write(S) 

zcat: Display a stored file compress(C) 

fiiser: identify processes using a file or file stmcture fuser(Q 

times, utime: Sets file access and modification . . . utime(S) 

Idfcn: common object file access routines ldfcn(F) 

cpio: Copies file archives in and out cpio(C) 

fcntl: file control options fcntl(M) 

uupick: Public XENIX-to-XENIX file copy, uuto uuto(C) 

umask: Sets and gets file creation mask umask(S) 

close: Closes a file descriptor. close(S) 

dup, dup2: Duplicates an open file descriptor. dup(S) 

file: Determines file type file(C) 

sact: Prints current SCCS file editing activity sact(CP) 

endpwent: Gets password file entry, /getpwnam, setpwent, . getpwent(S) 

putpwent: Writes a password file entry putpwent(S) 

setgrent, endgrent: Get group file entry, /getgrgid, getgmam, . . getgrent(S) 

utmpname: Accesses utmp file entry, endutent, getut(S) 

grep, egrep, fgrep: Searches a file for a pattem grep(Q 

proto: prototype job file for at proto(ADM) 

open: Opens file for reading or writing open(S) 

writing, sopen: Opens a file for shared reading and .... sopen(DOS) 

uudecode: decode a binary file for transmission via mail . . . uuencode(C) 

uuencode: encode a binary file for transmission via mail . . . uuencode(C) 

ar: Archive file format ar(F) 

mdevice: file format mdevice(F) 

mfsys: file format mfsys(F) 

mtune: file format mtune(F) 

sdevice: file format. sdevice(F) 

sfsys: file format sfsys(F) 

stune: file format stune(F) 

pnch: file format for card images .... pnch(F) 

intro: Introduction to file formats Intro(F) 

mkstr: Creates an error message file from C source mkstr(CP) 

implementation-specific/ limits: file header for limits(F) 

files fllehdr: file header for common object . . filehdr(F) 

constants unistd: file header for symbolic ..... unistd(F) 

Changes executable binary file headers, fixhdr: fixhdr(C) 
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split: Splits a file into pieces split(C) 

/Finds the slot in the utmp file of the current user. ttyslot(S) 

purge(C) purge: the policy file of the sanitization utility . . . purge(F) 

rename: renames a file or directory rename(DOS) 

the access permissions of a file or directory. /Qianges .... chmod(C) 

one. creat: Creates a new file or rewrites an existing .... creat(S) 

Gets the current position of the file pointer, tell: tell(DOS) 

Iseek: Moves read/write file pointer. Iseek(S) 

/ftell, rewind: Repositions a file pointer in a stream fseek(S) 

locking: Locks or unlocks a file region for reading or/ .... locking(S) 

Stat, fstat: Gets file status stat(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

/processes using a file or file structure fiiser: identify . . . fiiser(C) 

syms: common object file symbol table format syms(F) 

Prints or changes the name of a file system fsname: fsname(ADM) 

literal copy of UNIX file system volcopy: make .... volcopy(ADM) 

mkfs: Constructs a file system . mkfs(ADM) 

mount: Mounts a file system moimt(S) 

umoimt: Unmounts a file system umount(S) 

UNIX system volume fs: file system - format of fs(F) 

backup: Performs incremental file system backup backup(ADM) 

fsdb: File system debugger fsdb(ADM) 

volume, file system: Format of a system . . filesystem(F) 

fstyp: determine file system identifier fstyp(ADM) 

directory entry, dirent: file system independent dirent(F) 

fstatfs:get file system informatioa statfs(S) 

statfs: get file system information statfs(S) 

commands, fstab: File system mount and check . . . fstab(F) 

quot: Summarizes file system ownership quot(Q 

XENIX incremental file system restorer. /Invokes . . . xrestore(ADM) 

restore, restor: Invokes incremental file system restorer. restore(ADM) 

ustat: Gets file system statistics ustat(S) 

fsstat: report file system status fsstat(ADM) 

mnttab: Format of mounted file system table mnttab(F) 

- mount, unmount multiple file systems /umountall mountall(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

labelit: provide labels for file systems labelit(ADM) 

haltsys, reboot: Closes out the file systems and shuts down the/ . haltsys(ADM) 

fsck. checklist: List of file systems processed by .... checklist(F) 

serial/ consoleprint: Print file to printer attached to a .... consoleprint(ADM) 

/a XENIX-style Micnet routing file to MMDF fonnat mnlist(ADM) 

/converts XENIX-style aliases file to MMDF format mmdfalias(ADM) 

XENIX-style UUCP routing file to MMDF fonnat. /a uulist(ADM) 

tsort: Sorts a file topologically tsort(CP) 

the scheduler for the uucp file transport program uusched: . . uusched(ADM) 

ftw:Walksa file tree ftw(S) 

file: Determines file type. . file(C) 

umask:Sets file-creation mode mask umask(C) 

object files filehdr: file header for common . . filehdr(F) 

file, filelength: Gets the length of a . . fileleng(DOS) 
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mktemp: Makes a unique filename mktemp(S) 

ctermid: Generates a filename for a terminal ctermid(S) 

link: Links a new filename to an existing file. . . . link(S) 

status, ferror, feof, clearerr, fileno: Determines stream .... ferror(S) 

Creates and administers SCCS files, admin: admin(C3*) 

Format of tty device mapping files, mapchan: mapchan(F) 

Gets name list entries from files, xlist, fitlist: xlist(S) 

access and modification dates of files, settime: Changes the .... settime(ADM) 

and prints process accounting files, acctcom: Searches for ... acctcom(ADM) 

bfs: Scans big files bfs(C) 

cat: Concatenates and displays files cat(Q 

cmp: Compares two files cmp(C) 

copy: Copies groups of files copy(C) 

cp: Copies files cp(C) 

difB: Compares three files difiB(C) 

diffi Compares t^yo text files difiR;C) 

dosrm, dosrradir: Access DOS files, dosls, dos(C) 

fcntl: Controls open files fcntl(S) 

file header for common object files filehdr: filehdr(F) 

,find: Finds files find(C) 

fonnatspecific^C^reitisiext files fspec: fspec(F) 

lines common to tWo sorted files, comm: Selects or rejects . . comm(C) 

merge or add total accoui|^ng files acctmerg: acctmerg(ADM) 

miscellaneous features files, /to machine related .... Intro(HW) 

mknod: Bui^^Sfe special, files. mknod(C) 

parts of executatrflfe binaJy - files, hdr: Displays selected . . . hdr(CP) 

paste: Merges lines of files paste(C) 

purge: overwrites speciQed files purge(Q 

semaphores and record locking on files, lockf: Provide lockf(S) 

sort: Sorts and merges files sort(C) 

string, format of graphical files gps: graphical primitive . . . gps(F) 

tar: Archives files tar(Q 

to miscellaneous features and files, intro: Introduction Intro(M) 

top.next: The Micnet topology files, top, top(F) 

unpack: Compresses and expands files, pack, peat, pack(Q 

what: Identifies files what(C) 

csplit: Splits files according to context csplit(C) 

rep: Copies files across XENIX systems. . . . rcp(Q 

integrity: examine system files against authentication/ . . . integrity(ADM) 

link, unlink: link and unlink files and directories link: .... link(ADM) 

mv: Moves or renames files and directories mv(0 

idmkinit: read files containing specifications . . idmkinit(ADM) 

transit queue: MMDF queue files for storing mail in queue(ADM) 

translate: Translates files from one format to another . . translate(C) 

auditd: read audit collection files generated by the audit/ . . . auditd(ADM) 

cleantmp: remove temporary files in directories specified . . . cleantmp(ADM) 

hd: Displays files in hexadecimal format. . . . hd(C) 

od: Displays files in octal format od(C) 

dumpdir: Prints the names of files on a backup archive dumpdir(C) 

pr: Prints files on the standard output. . . . pr(C) 

rm, rmdir: Removes files or directories rm(C) 
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sdiffi Compares files side-by-side. sdifiR^C) 

coffconv: Convert 386 COFF files to XENIX format coffconv(M) 

bdifE Compares files too large for diff. bdiffi^C) 

control files, uuinstall: Administers UUCP uuinstall(ADM) 

ISO-9600 CD-ROM filesystem hs: High Sierra .... hs(F) 

mnt:Mounta filesystem mnt(C) 

High Sierra ISO-9660 CD-ROM filesystem . hs(F) 

Interactive, error-checking filesystem backup fsave: .... fsave(ADM) 

XENIX incremental filesystem backup. /Performs . . xbackup(ADM) 

/AT&T UNIX incremental filesystem backup restore .... restore(ADM) 

directory entry dirent: file-system-independent dirent(F) 

/Default information for mounting filesystems filesys(F) 

time dcopy: copy UNIX fi|pS(ystems for optimal access . . dcopy(ADM) 

greek: select terminal filter greek(C) 

pscat: ASCII-to-PostScript filter . pscat(C) 

tplot: graphics filters tplot(ADM) 

col: Filters reverse linefeeds col(C) 

service Ip filter: administer filters used with the LP print . . . lpfilter(ADM) 

driver object module, routines: finds driver entry points in a ... routines(ADM) 

find: Finds files find(C) 

finger: Finds information about users. . . finger(C) 

logname: Finds login name of user. .... logname(S) 

object library, lorder: Finds ordering relation for an . . . lorder(CP) 

hashmake, spellin, hashcheck: Finds spelling errors, spell, . . . spell(C) 

ttyname, isatty: Finds the name of a terminal. . . . ttyname(S) 

an object file, strings: Finds the printable strings in . . . strings(CP) 

of the current user, ttyslot: Finds the slot in the utmp file . . . ttyslot(S) 

users, finger: Finds information about . . finger(C) 

dbminit, feteh, store, delete, firstkey, nextkey: Performs/ . . . dbm(S) 

bad track table, badtrk: Scans fixed disk for flaws and creates . . badtik(ADM) 

binary file headers, fixhdr: Changes executable . . . fixhdr(C) 

badtiic: Scans fixed disk for flaws and creates bad track/ . . . badtrk(ADM) 

frexp, Idexp, modf: Splits floating-point number into a/ . . . frexp(S) 

/finod: Performs absolute value, floor, ceiling and remainder/ . . . floor(S) 

Performs absolute value, floor,/ floor, fabs, ceil, fmod: floor(S) 

diskcmp: Copies or compares floppy disks, diskcp, ...... diskcp(C) 

format: format floppy disks format(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

cflow: Generates C flow graph cflow(CP) 

buffers, flushall: Flushes all output .... flushall(DOS) 

fclose, fftush: Closes or flushes a stream fclose(S) 

flushall: Flushes all output buffers flushall(DOS) 

CPU. shutdn: Flushes block I/O and halts the . . shutdn(S) 

floor,/ floor, fabs, ceil, fmod: Performs absolute value, . . floor(S) 

device, vidi: Sets the font and video mode for a video . . vidi(C) 

stream, fopen, freopen, fdopen: Opens a . fopen(S) 

fork: Creates a new process. . . . foik(S) 

Convert 386 COFF files to XENIX format, coffconv: co£fconv(M) 

Displays files in hexadecimal format, hd: hd(C) 

aliases file to MMDF format, /converts XENIX-style . . mmdfalias(ADM) 

ar: Archive file format ar(F) 
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backup: Incremental dump tape format backup(F) 

common object file symbol table format syms: syms^ 

mdevice: file format mdevice(F) 

mfsys: file format mfsys(F) 

mtune: file format mtune(F) 

od: Displays files in octal format od(C) 

routing file to MMDF format, AJUCP uulist(ADM) 

routing file to MMDF format, /a XENIX-style Micnet . . mnlist(ADM) 

sdevice: file format sdevice(F) 

sfsys: file format sfsys(F) 

stune: file format stune(F) 

tar: archive format tar(F) 

strflime: format date/time string strftime(S) 

format: format floppy disks format(C) 

pnch: file format for card images pnch(F) 

86rel: Intel 8086 Relocatable Format for Object Modules. . . . 86rel(I0 

format: format floppy disks. . . . format(C) 

dir: Format of a directory dir(F) 

file system: Format of a system volume. . . . filesystem(F) 

newform: Changes the format of a text file newform(Q 

inode: Format of an inode inode(F) 

sccsfile: Format of an SCCS file sccsfile(F) 

editor output, a.out: Format of assembler and link . . . a.out(F) 

file, "terminfo:" Format of compiled terminfo . . . terminfo(F) 

core: Format of core image file core(IO 

cpio: Format of cpio archive cpio(F) 

file. scr_dump: formatof curses screen image . . scr_dump(F) 

gps: graphical primitive string, format of graphical files gps(F) 

table, mnttab: Format of mounted file system . . mnttab(F) 

file, acct: Format of per-process accounting . acct(F) 

volume fs: file system - formatof UNIX system fs(F) 

volume fs: file system format of UNIX system fs(F) 

group: Format of the group file group(M) 

files, mapchan: Format of tty device mapping . . mapchan(F) 

devices: Formatof UUCP devices file. . . devices(F) 

abbreviations file, dialcodes: Formatof UUCP dial-code .... dialcodes(IO 

dialers: Formatof UUCP Dialers file. . . . dialers(F) 

permissions: Ix)rmatof UUCP Permissions file. . permissions(F) 

poll: Fonnat of UUCP Poll file poll(F) 

sysfiles: Formatof UUCP Sysfiles file. . . sysfiles(F) 

systems: Formatof UUCP Systems file. . . systems(F) 

files fspec: format specification in text . . . fspec(F) 

Translates files from one format to another translate: . . . translate(C) 

intro: Introduction to file formats Intro(F) 

cscanf: Converts and formats console input. cscanf(DOS) 

fscanf, sscanf : Converts and formats input, scanf, ...... scanf(S) 

entries, utmp, wtmp: Formats of utmp and wtmp .... utmp(F) 

cprintf: Formats output cprintf(DOS) 

printf, fjprintf, sprintf: Formats output . printf(S) 

vfi)rintf, vsprintf: Prints formatted output of a/ vprintf, . . vprintf(S) 

service Ipforms: administer forms used with the LP print . . . lpfonns(ADM) 
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Rational FORTRAN into standard FORTRAN, ratfor: Converts . . . ratfor(CP) 
ratfor: Converts Rational FORTRAN into standard FORTRAN. ratfor(CP) 



and segment. fp_oft fip_seg: Return offeet . . . fip_seg(DOS) 

output, printf, :^rintf, sprintf: Formats printf(S) 

segment. ^_ofF, ^_seg: Return offeet and .... fp_seg(DOS) 

character to a stream. fi)utc, fputchar: Write a fi)utc(DOS) 

word on a/ putc, putchar, ^tc, putw: Puts a character or . . putc(S) 

stream, fjputc, putchar: Write a character to a . . fputc(DOS) 

stream, puts, fi)uts: Puts a string on a puts(S) 

binary input and output, firead, fwrite: Performs buffered . . frcad(S) 

main memory, malloc, free, realloc, calloc: Allocates . . malloc(S) 

fopen, freopen, fdopen: Opens a stream. . fopen(S) 

floating-point number into a/ frexp, Idexp, modf: Splits .... frexp(S) 

UNIX system volume fs: file system - format of .... fs(F) 

error-checking filesystem/ fsave: Interactive, fsave(ADM) 

formats input, scanf, fscanf, sscanf: Converts and . . . scanf(S) 

of file systems processed by fsck. checklist: List checklist(F) 

systems, fsck: Checks and repairs file ... fsck(ADM) 

fsdb: File system debugger. . . . fsdb(ADM) 

Repositions a file pointer in a/ fseek, ftell, rewind: fseek(S) 

name of a file system fsname: Prints or changes the . . . fsname(ADM) 

text files fspec: format specification in . . . fspec(F) 

semi-automated system backups fsphoto: Performs periodic .... fsphoto(ADM) 

status fsstat: report file system fsstat(ADM) 

check commands, fstab: File system mount and . . . fstab(F) 

Stat, fstat: Gets file status stat(S) 

information, fstatfs: get file system statfs(S) 

identifier fstyp: determine file system . . . fstyp(ADM) 

file pointer in a/ fseek, ftell, rewind: Repositions a ... fseek(S) 

time, ftime: Gets time and date time(S) 

communication package, ftok: Standard interprocess .... stdipc(S) 

ftw: Walks a file tree ftw(S) 

function and complementary error function, erf, erfc: Error .... erf(S) 

gamma: Performs log gamma function gamma(S) 

matherr: Error-handling fimction matherr(S) 

prof : profile within a function prof(M) 

function, erf, erfc: Error function and complementary error . erf(S) 

setkey: Assigns the function keys setkey(C) 

Performs screen and cursor functions, curses: curses(S) 

atan2: Performs trigoiwmetric functions, /asin, acos, atan, . . . trig(S) 

cosh, tanh: Performs hyperbolic functions, sinh, sinh(S) 

floor, ceiling and remainder fixnctions. /absolute value floor(S) 

jn,yO, yl.yn: Performs Bessel functions. bessel,jO,jl bessel(S) 

logarithm, power, square root functions, /exponential exp(S) 

nextkey: Performs database fiinctions. /delete, firstkey, . . . dbm(S) 

performs UNIX backup functions backup: backup(ADM) 

sysi86: machine specific functions sysi86(S) 

tgoto, tputs: Performs terminal functions, /tgetflag, tgetstr, . . . termcap(S) 

to DOS cross development functions, intro: Introduction . . intro(DOS) 

math: math fimctions and constants math(M) 

terminals hp: handle special functions of Hewlett-Packard . . . hp(C) 
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300: 300, 300s - handle special functions of DASI 300/ 300(Q 

450/ 450: handle special functions of tiie DASI 450(0 

input and output, frcad, fwrite: Perfonns buffered binary . fiead(S) 

manipulate connect accounting/ fwtmp: fwtmp, wtmpfix: fWtmp(ADM) 

connect accounting/ fwtmp: fwtmp, wtmpfix: manipulate . . . fwtmp(ADM) 

from files, xlist, fxlist: Gets name list entries . . . xlist(S) 

gamma: Perfonns log gamma function gamma(S) 

function, gamma: Perfomis log gamma . . . gamma(S) 

conversions, ecvt, fcvt, gcvt: Performs output ecvt(S) 

adb: Invokes a general-purpose debugger adb(CP) 

user ID diskusg: generate di^ accounting data by . diskusg(ADM) 

and /read audit collection files generated by the audit subsystem . auditd(ADM) 

terminal, ctermid: Generates a filename for a .... ctennid(S) 

rand, srand: Generates a random number. . . . rand(S) 

random: Generates a random number. . . . random(C) 

makekey: Generates an encryption key. . . . makekey(M) 

abort: Generates an lOT fault abort(S) 

cflow: Generates C flow graph cflow(CP) 

cross-reference, cxref: Generates C program cxref(CP) 

numbers, ncheck: Generates names from inode . . . ncheck(ADM) 

analysis, lex: Generates programs for lexical . . lex(C3*) 

srand48, seed48, lcong48: Generates uniformly distributed. . drand48(S) 

MMDF queue status report generator checkque: checkque(ADM) 

value machid: machid, 1386 get processor type truth machid(C) 

character or word from a/ getc, getchar, fgetc, getw: Gets . . getc(S) 

getch: Gets a character. getch(DOS) 

character or word from a/ getc, getchar, fgetc, getw: Gets .... getc(S) 

character, getche: Gets and echoes a .... getche(DOS) 

real-time clock getclk: gets string from getclk(M) 

current woricing directory, getcwd: Get the pathname of . . . getcwd(S) 

and put in a file, getdents: read directory entries . . getdents(S) 

getuid, geteuid, getgid, getegid: Gets real user,/ getuid(S) 

environment name, getenv: Gets value for getenv(S) 

real user, effective/ getuid, geteuid, getgid, getegid: Gets . . . getuid(S) 

effective/ getuid, geteuid, getgid, getegid: Gets real user, . . getuid(S) 

setgrent, endgrent: Get group/ getgrent, getgrgid, getgmam, . . . getgrent(S) 

endgrent: Get group/ getgrent, getgrgid, getgmam, setgrent, . . . getgrent(S) 

Get group/ getgrent, getgrgid, getgmam, setgrent, endgrent: . . . getgrent(S) 

geflogin: Gets login name getiogin(S) 

argument vector, getopt: Gets option letter from . . getopt(S) 

getopt: Parses command options. . getopt(C) 

options getopts: getopts, getoptcvt - parse command . . . getopts(Q 

command options getopts: getopts, getoptcvt - parse .... getopts(0 

parse command options getopts: getopts, getoptcvt - ... getopts(Q 

getpass: Reads a password. . . . getpass(S) 

process group, and/ getpid, getpgrp, getppid: Gets process, . . getpid(S) 

process, process group, and/ geQ)id, getpgrp, getppid: Gets . . getpid(S) 

group, and/ getpid, getpgrp, getppid: Gets process, process . . getpid(S) 

user ID. getpw: Gets password for a given . getpw(S) 

setpwent, endpwent: Gets/ getpwent, getpwuid, getpwnam, . . getpwent(S) 

Gets/ getpwent, getpwuid, getpwnam, setpwent, endpwent: . getpwent(S) 
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endpwent: Gets/ getpwent, getpwuid, getpwnam, setpwent, . . getpwent(S) 

getch: Gets a character. getch(DOS) 

fgetc, fgetchar: Gets a character from a stream. . . fgetc(DOS) 

an event queue. ev_getdev: Gets a list of devices feeding . . . ev_getdev(S) 

shmget: Gets a shared memory segment. . . shmget(S) 

cgets: Gets a string . cgets(DOS) 

gets, fgets: Gets a string from a stream. . . . gets(S) 

input, gets: Gets a string from the standard . . gets(CP) 

getche: Gets and echoes a character. . . . getche(DOS) 

ulimit: Gets and sets user limits. .... ulimit(S) 

getc, getchar, fgetc, getw: Gets character or word from a/ . . getc(S) 

dosextem Gets DOS error messages dosexter(DOS) 

nlist: Gets entries from name list. . . . nlist(S) 

a stream, gets, fgets: Gets a string from . . . gets(S) 

umask: Sets and gets file creation mask umask(S) 

Stat, fstat: Gets file status. stat(S) 

ustat: Gets file system statistics ustat(S) 

standard input, gets: Gets a string from the ... gets(CP) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

msgget: Gets message queue msgget(S) 

files, xlist, fidist: Gets name list entries from . . . xlist(S) 

system, uname: Gets name of current XENIX . . . imame(S) 

vector, getopt: Gets option letter from argument . getopt(S) 

/getpwnam, setpwent, endpwent: Gets password file entry getpwent(S) 

ID. getpw: Gets password for a given user . . getpw(S) 

times, times: Gets process and child process . . times(S) 

getpid, getpgrp, getppid: Gets process, process group, and/ . getpid(S) 

real/ /geteuid, getgid, getegid: Gets real user, effective user, . . . getuid(S) 

semget: Gets set of semaphores semget(S) 

getclk: gets string from real-time clock . . getclk(M) 

file pointer, tell: Gets the current position of the . . tell(DOS) 

filelength: Gets the length of a file flleleng(DOS) 

cuserid: Gets the login name of the user. . . cuserid(S) 

tty: Gets the terminal's name tty(C) 

time, ftime: Gets time and date time(S) 

getenv: Gets value for environment name. . getenv(S) 

and tenninal settings used by getty. "gettydefs: Speed" 

security actions for init and getty initcond: special initcond(ADM) 

modes, speed, and line/ getty: Sets terminal type, .... getty(M) 

ct: spawn getty to a remote terminal .... ct(C) 

settings used by getty. "gettydefs: Speed and 

getegid: Gets real user,/ getuid, geteuid, getgid getuid(S) 

from a/ getc, getchar, fgetc, getw: Gets character or word . . . getc(S) 

of directories. Is: Gives information about contents . ls(C) 

date and time/ ctime, localtime, gmtime, asctime, tzset: Converts . ctime(S) 

non-obviousness, goodpw: Check a password for . . goodpw(ADM) 

longjmp: Performs a nonlocal "goto", setjmp, setjmp(S) 

and checks access to a resource governed by a semaphore. /Awaits waitsem(S) 

format of grai^ical files gps: graphical primitive string, . . gps(F) 

cflow: Generates C flow graph cflow(CP) 
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graph: draw a graph graph(ADM) 

sag; system activity graph sag(ADM) 

graph: draw a graph graph(ADM) 

primitive string, fomiat of graphical flies gps: grai^cal . . gps(F) 

format of grai^cal files gps: graphical primitive string gps(F) 

tplot: graphics filters tplot(ADM) 

plot: gr^hics interface plot(F) 

greek: select terminal filter .... greek(C) 

file for a pattern, grep, egrep. fgrep: Searches a . . grep(Q 

newgip: Logs user into a new group newgip(Q 

/real user, effective user, real group, and effective group IDs. . . getuid(S) 

/getppid: Gets process, process group, and parent process IDs. . . getpid(S) 

passwd: Change login, group, or dialup shell password. . . passwd(C) 

copy: Copies groups of files copy(C) 

updates, and regenerates groups of programs. /Maintains, . make(CP) 

grpcheck: Checks group file. . . . giix:heck(C) 

signals, ssignal, gsignal: Implements software . . ssignal(S) 

shutdn: Flushes block I/O and halts the CPU shutdn(S) 

file systems and shuts down the/ haltsys, reboot: Closes out the . . haltsys(ADM) 

Hewlett-Packard terminals hp: handle special functions of ... . hp(C) 

DASI 300/ 300: 300, 300s handle special functions of ... . 300(Q 

DASV 300: 300, 300s - handle special functions of ... . 300(Q 

DASI 450 terminal 450: handle special functions of the . . 450(Q 

nohup: Runs a command immune to hangups and quits nohup(Q 

cmchk: Reports hard disk block size cmchk(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

hd: Internal hard disk drive hd(HW) 

scsinfo: display current SCSI hard disk information scsinfo(ADM) 

and size/ display hard disk partition, division, . . . dlayout(ADM) 

and removing/ hdutil: hard disk utility for displaying . . hdutil(ADM) 

uconfig: system hardware changes uconfig(ADM) 

hostid: print imique hardware ID hostid(ADM) 

hcreate, hdestroy: Manages hash search tables, hsearch, . . . hsearch(S) 

spell, hashmake, spellin, hashcheck: Fmds spelling/ .... spell(Q 

routing/ /builds the MMDF hashed database of alias and ... dbmbuild(ADM) 

Finds spelling errors, spell, hashmake, spellin, hashcheck: . . spell(Q 

search tables, hsearch, hcreate, hdestroy: Manages hash . hsearch(S) 

hexadecimal format, hd: Displays files in hd(C) 

hd: Internal hard disk drive. . . . hd(HW) 

tables, hsearch, hcreate, hdestroy: Manages hash search . . hsearch(S) 

executable binary files, hdr: Displays selected parts of . . hdr(CP) 

limits: file header for/ limits(F) 

scnhdr: section header for a common object file . . scnhdr(F) 

filehdnfile header for common object files . . filehdr(jo 

iuiistd:file header for symbolic constants . . unistd(F) 

Changes executable binary file headers, fixhdr: fixhdr(C) 

user, hello: Send a message to another . hello(ADM) 

program, assert: Helps verify validity of assert(S) 

hp: handle special functions of Hewlett-Packard terminals .... hp(C) 

hd: Displays files in hexadecimal format hd(C) 

CD-ROM filesystem hs: High Sierra/ISO-9600 ..... hs(F) 



1-33 



Permuted Index 



filesystem hs: High Sierra/ISO-9660 CD-ROM . hs(F) 

layers: protocol used between host and windowing terminal/ . . layers(M) 

terminal jagent: host control of windowing .... jagent(M) 

Hewlett-Packard terminals hp: handle special functions of . . hp(C) 

Manages hash search tables, hsearch, hcreate, hdestroy: .... hsearch(S) 

informatioa hwconlig: Read the configuration . hwconfig(ADM) 

sinh, cosh, tanh: Perfonns hyperbolic functions sinh(S) 

Euclidean distance, hypot, cabs: Determines hypot(S) 

i286emul: emulate 80286 .... i286emul(C) 

value machid: machid, 1386 - get processor type truth . . machid(C) 

Gets password for a given user ID. getpw: getpw(S) 

chgrp: Changes group ID chgrp(Q 

chown: Changes owner ID. chown(C) 

disk accounting data by user ID diskusg: generate diskusg(ADM) 

setpgrp: Sets process group ID setpgrp(S) 

imique hardware ID hostid: print hostid(ADM) 

hard disks /display logical SCSI ID numbers for current SCSI . . . scsinfo(ADM) 

IDs and names id: print user and group id(ADM) 

and names, id: Prints user and group IDs . . . id(C) 

kernel idbuild: build new UNIX system . idbuild(ADM) 

information idcheck: returns selected .... idcheck(ADM) 

issue: issue identification file issue(F) 

systemid: The Micnet system identification file systemid(F) 

fstyp: determine file system identifier fstyp(ADM) 

devnm: Identifies device name devnm(C) 

what: Identifies files what(C) 

file or file structure fusen identify processes using a . , . . fuser(C) 

or file structure fusen identify processes using a file . . fuser(Q 

or get device driver/ idinstall: add, delete, update, . . . idinstall(ADM) 

idleout: Logs out idle users idleout(ADM) 

idleout: Logs out idle users. . . . idleout(ADM) 

specifications idmkinit: read files containing . . idmkinit(ADM) 

group, and parent process IDs. /Gets process, process . . . getpid(S) 

real group, and effective group IDs. Aieal user, effective user, . . getuid(S) 

setgid: Sets user and group IDs. setuid, setuid(S) 

id: Prints user and group IDs and names id(Q 

id: print user and group IDs and names id(ADM) 

idspace: investigates free space . . idspace(ADM) 

a tunable parameter idtune: attempts to set value of . . idtune(ADM) 

core: Format of core image file core(F) 

format of curses screen image file. scr_dump: scr_dump(F) 

mem, kmem: Memory image file mem(M) 

crash: examine system images crash(ADM) 

pnch: file format for card images pnch(F) 

nohup: Runs a command immune to hangups and quits. . . nohup(Q 

limits: file header for implementation-specific/ .... limits(F) 

ssignal, gsignal: Implements software signals. . . . ssignal(S) 

event input. ev_gindev: include/exclude devices for ... ev_gindev(S) 

backup: Incremental backup tape format. . backup(F) 

restore, reston Invokes incremental file systern/ restore(ADM) 

xrestore: Invokes XENIX incremental file system/ xrestore(ADM) 



1-34 



Permuted Index 



backup: Perfoims incremental file system backup. . . backup(ADM) 

restore: AT&T UNIX incremental filesystem backup/ . . restore(ADM) 

xbackup: Perfonns XENIX incremental filesystem backup. . . xbackup(ADM) 

dirent: file system independent directory entry. . . . dirent(F) 

and teletypes last: Indicate last logins of users . . . last(Q 

"tenninfo descriptions" infocmp: compare or print out . . 

/Default backup device informatioa arciiive(F) 

database of alias and routing information, /bashed dbmbuild(ADM) 

fstatfs: get file system information. statfs(S) 

hwconfig: Read the configuration information hwconfig(ADM) 

prints lineprinter status information. Ipstat: lpstat(C) 

pstat: Reports system infonnation pstat(Q 

statfs: get file system information statfs(S) 

vdinfo: display virtual disk information vdinfo(ADM) 

initialization, init, inir: Process control init(M) 

special security actions for init and getty initcond: initcond(ADM) 

initialization, init, inir: Process control .... init(M) 

actions for init and getty initcond: special security .... initcond(ADM) 

init, inir: Process control initialization init(M) 

vddaemon: virtual disk initialization vddaemon(ADM) 

brc: brc, bcheckrc - system initialization procedures brc(ADM) 

process, popen, pclose: Initiates I/O to or from a popen(S) 

terminals file, inittab: Alternative login .... inittab(F) 

clri: Qears inode clri(ADM) 

inode: Format of an inode inode(F) 

inode: Format of an inode. .... inode(F) 

ncheck: Generates names from inode numbers ncheck(ADM) 

inp: Returns a byte inp(DOS) 

Converts and formats console input, cscanf: cscanf(DOS) 

Gets a string from the standard input, gets: gets(CP) 

Opens an event queue for input. ev_open: ev_open(S) 

devices for event input. Anclude/exclude ev_gindev(S) 

sscanf: Converts and formats input, scanf, fscanf, scanf(S) 

Perfonns standard buffered input and output, stdio: stdio(S) 

fwrite: Perfonns buffered binary input and output, fread, frcad(S) 

Pushes character back into input stream, ungetc: ungetc(S) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

uustat: uucp status inquiry and job control uustat(Q 

script, install: Installation shell instalI(M) 

installpkg: install package instaIIpkg(ADM) 

install: Installation shell script install(M) 

xinstall: XENIX installation shell script ..... xinstall(ADM) 

removepkg: remove installed package removepkg(ADM) 

displaypkg: display installed packages displaypkg(ADM) 

installpkg: install package .... installpkg(ADM) 

creatsem: Creates an instance of a binary semaphore. . . creatsem(S) 

int86: Executes an interrupt. ... int86(DOS) 

int86x: Executes an interrupt. . . int86x(DOS) 

call, intdos: Invokes a DOS system . . intdos(DOS) 

call, intdosx: Invokes a DOS system . . intdosx(DOS) 

atol, atoi: Converts string to integer, strtol strtol(S) 
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the absolute value of a long integer, labs: Returns labs(DOS) 

abs: Returns an integer absolute value abs(S) 

A64a: Converts between long integer and base 64 ASCII. . . . a641(S) 

sputl, sgetl: Accesses long integer data in a/ sputl(S) 

between 3-byte integers and long integers. /ItolS: Converts .... 13tol(S) 

itoa: Converts numbers to integers. . itoa(DOS) 

/ltol3: Converts between 3-byte integers and long integers 13tol(S) 

Itoa: Converts long integers to characters Itoa(DOS) 

against authentication database integrity: examine system files . . integrity(ADM) 

for Object Modules. 86rel: Intel 8086 Relocatable Fbrmat . . 86rel(F) 

filesystem backup fsave: Interactive, error-checking .... fsave(ADM) 

system mailx: interactive message processing . . mailx(C) 

plot:grai^cs interface plot(F) 

rtc: real time clock interface rtc(HW) 

scsi: Small computer systems interface scsi(HW) 

swap: swj^ administrative interface swap(ADM) 

termio: General terminal interface teniiio(M) 

termios: POSIX general terminal interface termios(M) 

tty: Special terminal interface tty(M) 

cdrom: compact disk interface cdrom(HW) 

audit: audit subsystem interface device audit(ADM) 

STREAMS configuration interface for networking/ .... strmtune(ADM) 

activationy auditcmd: command interface for audit subsystem . . . auditcmd(ADM) 

authtsh: administrator interface for authorization/ .... authtsh(ADM) 

/,tty2[a-h] ,tty2[A-H]: Interface to serial ports serial(HW) 

lpl,lp2: Line printer device interfaces. Ip, IpO, Ip(HW) 

Authentication/ authck: check internal consistency of authck(ADM) 

hd: Internal hard disk drive hd(HW) 

setlocale: Set or read international environment .... setlocale(S) 

locale: The international locale. locale(M) 

spline: Interpolates smooth curve spline(CP) 

a restricted shell (command interpreter), rsh: Invokes .... rsh(C) 

sh: Invokes the shell command interpreter sh(C) 

csh: Invokes a shell command interpreter with C-like syntax. . . csh(C) 

ipcs: Reports the status of inter-process communication/ . . ipcs(ADM) 

package, ftok: Standard interprocess communication . . . stdipc(S) 

pipe: Creates an interprocess pipe pipe(S) 

int86: Executes an interrupt int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

Suspends execution for a short interval, nap: nap(S) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 

services, library routines and/ intro: Introduces system Intro(S) 

Development System commands, intro: Introduces XENIX .... Intro(CP) 

commands, intro: Introduces XENIX .... Intro(C) 

miscellaneous features and/ intro: Introduction to Intro(M) 

development functions, intro: Introduction to DOS cross . intro(DOS) 

formats, intro: Introduction to file .... Intro(F) 

related miscellaneous features/ intro: Introduction to machine . . Intro(HW) 

library routines and/ intro: Introduces system services, . . . Intro(S) 

intro: Introduces XENIX commands. . . Intro(C) 
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System commands, intra: Introduces XENIX Development . Intro(CP) 

development functions, intra: Introduction to DOS cross .... intro(DOS) 

intra: Introduction to file fomiats. . . . Intro(F) 

miscellaneous features/ intro: Introduction to machine related . . Intro(HW) 

features and files, intro: Introduction to miscellaneous . . Intro(M) 

idspace: investigates free space idspace(ADM) 

be: Invokes a calculator bc(C) 

yacc: Invokes a compiler-compiler. . . . yacc(CP) 

bdos: Invokes a DOS system call. . . . bdos(DOS) 

intdos: Invokes a DOS system call. . . . intdos(IX)S) 

intdosx: Invokes a DOS system call. . . . intdosx(DOS) 

debugger, adb: Invokes a general-purpose .... adb(CP) 

m4: Invokes a macro processor. . . . m4(CP) 

calendar Invokes a reminder service. . . . calendar(C) 

(command interpreter), rsh: Invokes a restricted shell .... rsh(C) 

red: Invokes a restricted version of. . . red(Q 

display/ vi, view, vedit: Invokes a screen-oriented .... vi(C) 

interpreter with C-like/ csh: Invokes a shell command .... csh(C) 

ex: Invokes a text editor. ex(C) 

calculator, dc: Invokes an arbitrary precision . . dc(C) 

restore, restor: Invokes incremental file system/ . restore(ADM) 

incremental file/ xrestore: Invokes XENIX xrestore(ADM) 

sdb: Invokes symbolic debugger. . . . sdb(CP) 

cc: Invokes the C compiler. cc(CP) 

evjnit: Invokes the event manager. . . . ev_init(S) 

Id: Invokes the link editor. Id(CP) 

Id: Invokes the link editor. ld(M) 

interpreter, sh: Invokes the shell command . . . sh(Q 

sed: Invokes the stream editor. .... sed(C) 

ed: Invokes the text editor. ed(C) 

masm: Invokes the XENIX assembler. . . masm(CP) 

vdutil: restart I/O on a mirrored disk vdutil(ADM) 

shutdn: Flushes block I/O and halts the CPU shutdn(S) 

select: synchronous 1/0 multiplexing select(S) 

popen, pclose: Initiates I/O to or from a process popen(S) 

devices, ioctl: Controls character ioctl(S) 

abort: Generates an lOT fault abort(S) 

semaphore set or shared memory, ipcrm: Removes a message queue, ipcrm(ADM) 

inter-process communication/ ipcs: Reports the status of .... ipcs(ADM) 

^slower, isdigit, isxdigit, isalnum, isspace, ispuncty .... ctype(S) 

isdigit, isxdigity ctype, isalpha, isupper, islower, .... ctype(S) 

isverify: verifies ISAM database entries isverify(M) 

^sprint, isgraph, iscntri, isascii, tolower, touppery .... ctype(S) 

device, isatty: Checks for a character . . . isatty(DOS) 

terminal, ttyname, isatty: Finds the name of a .... ttyname(S) 

Aispunct, isprint, isgraph, iscntri, isascii, tolowery ctype(S) 

^rsaJpha, isupper, islower, isdigit, isxdigit, isalnumy .... ctype(S) 

isspace, ispunct, isprint, isgraph, iscntri, isasciiy ctype(S) 

ctype, isalpha, isupper, islower, isdigit, isxdigity .... ctype(S) 

state ismpx: return windowing terminal . ismpx(C) 

hs: High Sierra ISO-9600 CD-ROM filesystem . . hs(F) 
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filesystem hs: High Sierra ISO-9660 CD-ROM hs(F) 

^salnum, isspace, ispunct, isprint, isgraph, iscntriy ctype(S) 

Aisxdigit, isalnum, isspace, ispunct, isprint, isgraphy .... ctype(S) 

^sdigit, isxdigit, isalniun, isspace, ispunct, isprinty .... ctype(S) 

issue: issue identification file issue(F) 

issue: issue identification file . . . issue(F) 

isxdigity ctype, isalpha, isupper, islower, isdigit, ctype(S) 

Aisupper, islower, isdigit, isxdigit, isalnum, isspace^ .... ctype(S) 

news: Print news items news(C) 

integers, itoa: Converts numbers to .... itoa(DOS) 

Bessel functions, bessel, jO,jl,jn,yO,yl,yn: Performs . . bessel(S) 

Bessel functions, bessel, jO, jl,jn,yO,yl,yn: Performs .... bessel(S) 

windowing terminal jagent: host control of jagent(M) 

functions, bessel, jO,jl, jn,yO,yl,yn: Performs Bessel . . bessel(S) 

join: Joins two relations join(C) 

join: Joins two relations join(C) 

terminal jterm: reset layer of windowing . . jterm(Q 

jwin: print size of layer jwin(Q 

keystroke, kbhit: Checks the console for a . . kbhit(DOS) 

test keyboard support kbmode: Set keyboard mode or . . kbmode(ADM) 

builds a new U^fIX system kernel. link_unix: link_unix(ADM) 

idbuild: build new UNIX system kernel idbuild(ADM) 

meisa: master EISA system kernel configuration file .... meisa(F) 

/or remove line disciplines from kernel configuration files .... idaddld(ADM) 

error: Kernel error output device. . . . error(M) 

makekey: Generates an encryption key makekey(M) 

keyboard: The PC keyboard keyboard(HW) 

support kbmode: Set keyboard mode or test keyboard . kbmode(ADM) 

Set keyboard mode or test keyboard support kbmode: . . . kbmode(ADM) 

keyboard: The PC keyboard. . . . keyboard(HW) 

setkey: Assigns the function keys setkey(C) 

kbhit: Checks the console for a keystroke kbhit(DOS) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

kiUall: kill all active processes killall(ADM) 

process or a group of/ kill: Sends a signal to a kill(S) 

kill: Terminates a process. .... kill(C) 

processes killall: kill all active killall(ADM) 

mem, kmem: Memory image file. . . . mem(M) 

contents of directory. 1: Lists information about .... 1(Q 

3-byte integers and long/ 13tol, ltol3: Converts between . . 13tol(S) 

integer and base 64/ a641, 164a: Converts between long . . . a641(S) 

systems labelit: provide labels for file . . . labeUt(ADM) 

labelit: provide labels for file systems labelit(ADM) 

of a long integer, labs: Returns the absolute value . . labs(DOS) 

cpp:TheC language preprocessor. cpp(CP) 

lint: Checks C language usage and syntax. . . . lint(CP) 

/chargefee, ckpacct, dodisk, lasUogin, monacct, nuUadm,/ . . . acctsh(ADM) 

jwin: print size of layer jwin(Q 

login entry to show current layer relogin: rename relogin(ADM) 

shl: Shell layer manager. shl(C) 

terminals layers: layer multiplexer for windowing . layers(Q 
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jterm: reset layer of windowing terminal . . . jtenn(C) 

windowing tenninals layers: layer multiplexer for ... layers(Q 

host and windowing terminal/ layers: protocol used between . . layers(M) 

columns. Ic: Lists directory contents in . . . lc(C) 

distributed. srand48, seed48, lcong48: Generates uniformly . . drand48(S) 

Id: Invokes the link editor. .... ld(CP) 

Id: Invokes the link editor. .... ld(M) 

floating-point number/ frexp, Idexp, modf: Splits frexp(S) 

routines Idfcn: common object file access . ldfcn(F) 

filelength: Gets the lengthof a file fileleng(DOS) 

strlen: Returns the length of a string. . strlen(DOS) 

getopt: Gets option letter from argument vector, . . . getopt(S) 

banner: Prints large letters banner(Q 

lexical analysis, lex: Generates programs for ... lex(CP) 

lex: Generates programs for lexical analysis lex(CP) 

and update. Isearch. Ifind: Performs linear search . . . lsearch(S) 

Converts archives to random libraries, ranlib: ranlib(CP) 

ar: Maintains archives and libraries ar(CP) 

ordering relation for an object library, lorder: Finds lorder(CP) 

/Introduces system services, library routines and error/ .... Intix)(S) 

maxuuscheds: UUCP uusched limit file maxuuscheds(F) 

maxuuxqts: UUCP uuxqt limit file maxuuxqts(F) 

ulimit: Gets and sets user limits ulimit(S) 

implementation-specific/ limits: file header for limits(F) 

line: Reads one line line(C) 

idaddid: add or remove line disciplines from kernel/ . . . idaddld(ADM) 

files idaddid: add or remove line disciplines from kernel/ . . . idaddld(ADM) 

Isearch, Ifind: Performs linear search and update Isearch(S) 

col: Filters reverse linefeeds col(C) 

a common object file linenum: line number entries in . . linenum(F) 

cancel: Send/cancel requests to lineprinter. Ip IpCQ 

Ipshut, Ipmove: Starts/stops the lineprinter request Ipsched, . . . lpsched(ADM) 

Ipadmin: Configures the lineprinter spooling system. . . . Ipadmin(ADM) 

Ipstat: prints lineprinter status information. . . Ipstat(C) 

Adds, reconfigures and maintains lineprinters. Ipinit: Ipinit(ADM) 

files, comm: Selects or rejects lines common to two sorted . . . comm(Q 

rmb: remove extra blank lines from a file nnb(M) 

uniq: Reports repeated lines in a file uniq(Q 

head: Prints the first few lines of a stream head(Q 

paste: Merges lines of files paste(C) 

wc: Counts lines, words and characters. . . . wc(Q 

directories link: link, unlink: link and unlink files and link(ADM) 

Id: Invokes the link editor. Id(CP) 

Id: Invokes the link editor. ld(M) 

a.out: Format of assembler and link editor output a.out(F) 

unlink files and directories link: link, unlink: link and .... link(ADM) 

existing file, link: Links a new filename to an . link(S) 

In: Makes a link to a file ln(Q 

files and directories link: link, unlink: link and unlink . . . link(ADM) 

dosld: XENIX to MS-DOS cross linker. dosld(eP) 

existing file, link: Links a new filename to an .... link(S) 
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UNIX system kernel. link_unix: builds a new link_unix(ADM) 

and syntax, lint: Checks C language usage . . lint(CP) 

nlist: Gets entries from name list nlist(S) 

nm: Prints name list nm(CP) 

of a vararg^ argument list. /Prints formatted output . . . vprintf(S) 

varargs: variable argument list varargs(S) 

xlist, fxlist: Gets name list entries from files . xlist(S) 

MMDF list: list processor channel for . . list(ADM) 

queue. ev_getdev: Gets a list of devices feeding an event . . ev _getdev(S) 

by fsck. checklist: List of file systems processed . . . checklist(F) 

majorsinuse: displays the list of major device numbers/ . . . majorsinuse(ADM) 

terminals: List of supported terminals. . . . terminals(M) 

swconfig: produces a list of the software/ . swconfig(C) 

vectorsinuse: displays the list of vectors currently/ vectorsinuse(ADM) 

list: hst processor channel for MMDF . list(ADM) 

nlsadmin: network listener service administration . . nlsadmin(ADM) 

cref: Makes a cross-reference listing cref(CP) 

columns. Ic: Lists directory contents in .... lc(C) 

of directory. 1: Lists information about contents . 1(C) 

who: Lists who is on the system who(C) 

file system volcopy: make literal copy of UNIX volcopy(ADM) 

In: Makes a link to a file ln(C) 

locale: The international locale locale(M) 

mestbl: create a messages locale file mestbl(M) 

chrtbl: create a ctype locale table chrtbl(M) 

coltbl: create a collation locale table . coltbl(M) 

curtbl: create a currency locale table curtbl(M) 

numtbl: Create a numeric locale table numtbl(M) 

locale, locale: The international .... locale(M) 

netwoik. mmdf: routes mail locally and over any supported . . mmdf(ADM) 

tzset: Converts date and/ ctime, localtime, gmtime, asctime, . . . ctime(S) 

end, etext, edata: Last locations in program end(S) 

memory, lock: Locks a process in primary . lock(S) 

lock: Locks a user's terminal. . . lock(C) 

memory, plock: Lock process, text, or data in . . . plock(S) 

record locking on files, lockf : Provide semaphores and . . lockf(S) 

region for reading or writing, locking: Locks orimlocks a file . . locking(S) 

Provide semaphores and record locking on files, lockf: ..... lockf(S) 

memory, lock: Locks a process in primary . . . lock(S) 

lock: Locks a user's terminal lock(C) 

for reading or/ locking: Locks or unlocks a file region . . locking(S) 

gamma: Performs log gamma function gamma(S) 

exponential, logarithm,/ exp, log, pow, sqrt, loglO: Performs . . exp(S) 

logarithm^ exp, log, pow, sqrt, loglO: Performs exponential, . . . exp(S) 

AoglO: Performs exponential, logarithm, power, square root/ . . exp(S) 

logs: MMDF logfiles logs(F) 

strclean: STREAMS error logger cleanup program ..... strclean(ADM) 

strerr: STREAMS error logger daemon strerr(ADM) 

current SCSI hard disks /display logical SCSI ID numbers for ... scsinfo(ADM) 

layer relogin: rename login entry to show current . . . relogin(ADM) 

password, passwd: Change login, group, or dialup shell • • - . passwd(C) 
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getlogin: Gets login name getlogin(S) 

logname: Gets login name. logname(C) 

cuserid: Gets the login name of the user. cuserid(S) 

logname: Finds login name of user logname(S) 

passwd: Changes login password. passwd(C) 

terminal: Login terminal tenninal(HW) 

inittab: Alternative login terminals file inittab(F) 

Sets up an environment at login time, profile: profile(M) 

last: Indicate last logins of users and teletypes . . . last(C) 

user, logname: Finds login name of . . logname(S) 

logname: Gets login name logname(C) 

logs:MMDFlogfiles logs(F) 

idleout: Logs out idle users idleout(ADM) 

newgrp: Logs user into a new group. . . . newgrp(C) 

"goto", setjmp, longjmp: Performs a nonlocal . . setjmp(S) 

for an object library, lorden Finds ordering relation . . lorder(CP) 

Converts uppercase characters to lowercase, strlwr: strlwr(DOS) 

uppercase, strupr: Converts lowercase characters to strupr(DOS) 

requests to lineprinter. Ip, cancel: Send/cancel lp(C) 

device interfaces. Ip,lp0,lpl,lp2: Line printer . . . lp(HW) 

administer filters used with the LP print service Ipfilten .... lpfilter(ADM) 

administer forms used with the LP print service Ipfonns: .... lpfonns(ADM) 

utility Ipsh: Menu driven Ip print service administration . . lpsh(ADM) 

device interfaces. Ip, Ip0,lpl,lp2: Lineprinter .... lp(HW) 

interfaces. Ip, IpO, lpl,lp2: Line printer device . . . lp(HW) 

interfaces. Ip, IpO, Ipl, lp2: Line printer device lp(HW) 

lineprinter spooling system. Ipadmin: Configures the lpadmin(ADM) 

used with the LP print service Ipfilter: administer filters .... lpfilter(ADM) 

with the LP print service Ipforms: administer forms used . . lpforms(ADM) 

maintains lineprinters. Ipinit: Adds, reconfigures and . . lpinit(ADM) 

lineprinter/ Ipsched, Ipshut, Ipmove: Starts/stops the Ipsched(ADM) 

attached to the user's terminal Iprint: Print to a printer Iprint(C) 

Starts/stops the lineprinter/ Ipsched, Ipshut, Ipmove: lpsched(ADM) 

service administration utility Ipsh: Menu driven Ip print .... Ipsh(ADM) 

lineprinter request Ipsched, Ipshut, Ipmove: Start^stops the . . lpsched(ADM) 

status informatioa Ipstat: prints lineprinter lpstat(C) 

priorities Ipusers: set printing queue .... Ipusers(ADM) 

contents of directories. Is: Gives information about ... ls(C) 

search and update. Isearch, Ifind: Performs linear . . lsearch(S) 

pointer. Iseek: Moves read/write file ... lseelc(S) 

characters. Itoa: Converts long integers to . . ltoa(DOS) 

integers and long/ 13tol, ltol3: Converts between 3-byte . . 13tol(S) 

m4: Invokes a macro processor. . . m4(CP) 

type truth value machid: machid, 1386 - get processor . . . machid(C) 

processor type truth value machid: macliid, 1386 - get .... machid(C) 

features/ intro: Introduction to machine related miscellaneous . . Intro(HW) 

sysi86: machine specific functions. . . . sysi86(S) 

values: machine-dependent values .... values(M) 

Accesses long integer data in a machine-independent /sgetl: . . sputl(S) 

m4: Invokes a macro processor m4(CP) 

program, tape: Magnetic tape maintenance . . . tape(C) 
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tapedump: Dumps magnetic tape to output file. . . . tapedump(C) 

Sends, reads or disposes of mail, mail: mail(Q 

binary file for transmission via mail uudecode: decode a .... uuencode(Q 

binary file for transmission via mail uuencode: encode a .... uuencode(C) 

msgrread mail msg(Q 

maildelivery: user mail delivery specification file . . maildelivery(F) 

deliver: MMDF mail delivery process deliver(ADM) 

submit: MMDF mailenqueuer submit(ADM) 

MMDF queue files for storing mail in transit queue: queue(ADM) 

supported netwoik. mmdf: routes mail locally and over any .... mmdf(ADM) 

rmail: submit remote mail received via UUCP .... nnail(ADM) 

away rcvtrip: notifies mail sender that recipient is ... rcvtrip(C) 

of mail, mail: Sends, reads or disposes . . mail(Q 

but not/ checkmail: checks for mail which has been submitted . . checkmail(C) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

processing system mailx: interactive message .... mailx(Q 

free, realloc, calloc: Allocates main memory, malloc malloc(S) 

fdisk: Maintain disk partitions fdisk(ADM) 

libraries, ar: Maintains archives and ar(CP) 

Ipinit: Adds, reconfigures and maintains lineprinters lpinit(ADM) 

regenerates groups oV make: Maintains, updates, and make(CP) 

systty: System maintenance device systty(M) 

tape: Magnetic tape maintenance program tape(0 

hard disk device major/minor numbers /display . . hdutil(ADM) 

of major device numbers/ majorsinuse: displays the list . . . majorsinuse(ADM) 

key. makekey: Generates an encryption makekey(M) 

cref: Makes a cross-reference listing. . . cref(CP) 

execseg: makes a data region executable, . execseg(S) 

sees file, delta: Makes a delta (change) to an . . . delta(CP) 

mkdir: Makes a directory mkdir(Q 

or ordinary file, mknod: Makes a directory, or a special . . mknod(S) 

In: Makes a link to a file ln(0 

mktemp: Makes a unique filename mktemp(S) 

another user, su: Makes the user a super-user or . . su(Q 

Allocates main memory, malloc, free, realloc, calloc: . . . malloc(S) 

evjnit: Invokes the event manager ev_init(S) 

shl: Shell layer manager. shl(Q 

tsearch, tfind, tdelete, twalk: Manages binary Search trees. . . . tsearch(S) 

hsearch, hcreate, hdestroy: Manages hash search tables. . . . hsearch(S) 

records fwtmp: fwtmp, wtmpfix: manipulate connect accounting . . fwtmp(ADM) 

/floating-point number into a mantissa and an exponent frexp(S) 

ascii: Map of the ASCII character set. . . ascii(M) 

mapping, mapchan: Configure tty device . . mapchan(M) 

mapping files, mapchan: Format of tty device . . mapchan(F) 

convkey: Configure monitor/ mapkey, mapscm, mapstr, .... mapkey(M) 

Configure monitor screen mapping. Anapstr, convkey: ... mapkey(M) 

mapchan: Configure tty device mapping mapchan(M) 

mapchan: Format of tty device mapping files mapchan(F) 

usemouse: Maps mouse input to keystrokes . usemouse(C) 

Configure monitor/ mapkey, mapscm, mapstr, convkey: .... mapkey(M) 

monitor screen/ mapkey, mapscm, mapstr, convkey: Configure . . . mapkey(M) 
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Return the current event mask. ev_getemask: ev_gtemsk(S) 

Sets and gets flOle creation mask, umask: umask(S) 

ev_setemask: Sets event mask ev_stemsk(S) 

umask: Sets file-creation mode mask umask(Q 

assembler, masm: Invokes the XENIX . . . masm(CP) 

Regular expression compile and match routines, regexp: regexp(S) 

math: math functions and constants . . . math^) 

constants math: math functions and .... math(M) 

function, mathem Error-handling matherr(S) 

limit file, maxuuscheds: UUCP uusched . . maxuuscheds(F) 

limit file, maxuuxqts: UUCP uio^^ .... maxuuxqts(F) 

currently specified in the mdevice file /device numbers . . majorsinuse(ADM) 

mdevice: file format mdevice(F) 

mem,kmem:Memoiy image file. . mem(M) 

Lock process, text, or data in memory, plock: plock(S) 

lock; Locks a process in primary memory lock(S) 

queue, semaphore set or shared memory. /Removes a message . . ipcrm(ADM) 

realloc, calloc: Allocates main memory, malloc, free, malloc(S) 

adjusted when adding more memory 4)arameters to be .... memtune(F) 

parameters to match system memory Adjust tunable , idmemtune(ADM) 

mem,kmem: Memory image file. mem(M) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

Reports virtual memory statistics, vmstat: .... vmstat(C) 

administration/ atcronsh: Menu driven at and cron .... atcronsh(ADM) 

utility auditsh: Menu driven audit administration . auditsh(ADM) 

administration/ backupsh: Menu driven backup backupsh(ADM) 

administration utility Ipsh: Menu driven Ip print service . . . Ipsh(ADM) 

administration/ sysadmsh: Menu driven system sysadmsh(ADM) 

files acctmerg: merge or add total accounting . . acctmerg(ADM) 

sort: Sorts and merges files sort(Q 

paste: Merges lines of files paste(C) 

sent to a terminal, mesg: Permits or denies messages . mesg(C) 

msgctl: Provides message control operations. . . . msgctl(S) 

mkstr: Creates an error message file from C source. . . . mkstr(CP) 

msgop: Message operations msgop(S) 

mailx: interactive message processing system . . . mailx(Q 

msgget:Gets message queue msgget(S) 

shared memory, ipcrm: Removes a message queue, semaphore set or . ipcrm(ADM) 

hello: Send a message to another user. .... hello(ADM) 

Description of system console messages, messages: messages(M) 

Prints STREAMS trace messages strace: strace(ADM) 

dosexterr: Gets DOS error messages dosexter(DOS) 

ermo: Sends system error messages. /sys_nerr, ...... perror(S) 

console messages, messages: Description of system . messages(M) 

mestbl: create a messages locale file mestbl(M) 

mesg: Permits or denies messages sent to a terminal. . . . mesg(C) 

file mestbl: create a messages locale . mestbl(M) 

mfsys: file format mfsys(F) 

(F) mfsys; file format. ....... mfsys 



1-43 



Permuted Index 



micnet: The Micnet default commands file. . . micnet(F) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

mnlist: converts a XENIX-style Micnet routing file to/ mnlist(ADM) 

file. systemid:The Micnet system identification . . . systemid(F) 

commands file, micnet: The Micnet default . . . micnet(F) 

top, top.next: The Micnet topology files top(F) 

vdutil: rebuild a mirrored disk vdutil(ADM) 

vdutil: repair bad block on a mirrored disk vdutil(ADM) 

vdutil: restart I/O on a mirrored disk vdutil(ADM) 

add.vd: add a mirrored (virtual) disk add.vd(ADM) 

del.vd: delete a mirrored (virtual) disk del.vd(ADM) 

/- overview of accounting and miscellaneous accounting/ .... acct(ADM) 

/Introduction to machine related miscellaneous features and/ . . . Intro(HW) 

files, intro: Introduction to miscellaneous features and . . . Intro(M) 

mkdir: Creates a new directory. . . mkdir(DOS) 

mkdir: Makes a directory mkdir(Q 

mkfs: Constructs a file system. . . mkfs(ADM) 

mknod: Builds special files. . . . mknod(Q 

special or ordinary file, mknod: Makes a directory, or a . . mknod(S) 

file from C source, mkstr: Creates an error message . mkstr(CP) 

mktemp: Makes a unique filename. mktemp(S) 

list: list processor channel for MMDF list(ADM) 

program checkaddr. MMDF address verification . . . checkaddr(ADM) 

/Micnet routing file to MMDF format mnlist(ADM) 

/UUCP routing file to MMDF format uulist(ADM) 

XENIX-style aliases file to MMDF format, /converts .... mmdfalias(ADM) 

alias and/ dbmbuild: builds the MMDF hashed database of .... dbmbuild(ADM) 

logs: MMDFlogfiles logs(F) 

deliver: MMDF mail delivery process . . deliver(ADM) 

submit: MMDF mail enqueuer submit(ADM) 

tables: MMDF Name Tables tablesCF) 

mail in transit queue: MMDF queue files for storing . . queue(ADM) 



generator checkque: MMDF queue status report . . . checkque(ADM) 

over any supported network, mmdf: routes mail locally and . . mmdf(ADM) 

aliases file to MMDF/ mmdfalias: converts XENIX-style . mmdfalias(ADM) 

Micnet routing file to/ mnlist: converts a XENIX-style . . mnlist(ADM) 



mm: Mount a filesystem mnt(C) 

system table, mnttab: Format of mounted file . . mnttab(F) 

setmode: Sets translation mode setmode(DOS) 

sulogin: access single-user mode sulogin(ADM) 

vidi: Sets the font and video mode for a video device. .... vidi(C) 

umask: Sets file-creation mode mask umask(Q 

chmod: Changes mode of a file chmod(S) 

kbmode: Set keyboard mode or test keyboard support . . kbmode(ADM) 

dial: Dials a modem dial(ADM) 

pcu: modem port configuration .... pcu(ADM) 

uuchat: dials a modem dial(ADM) 

xprcat: transparent printer over modem line command xprcat(Q 

tset: Sets terminal modes tset(C) 

setmode: port modes utility setmode(C) 

getty: Sets terminal type, modes, speed, and line/ getty(M) 
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uugetty: set tenninal type, modes, speed, and line/ uugetty(ADM) 

number into a/ £rexp,ldexp, modf: Splits floating-point .... frexp(S) 

settime: Changes the access and modification dates of files settime(ADM) 

utime: Sets file access and modification times utime(S) 

touch: Updates access and modification times of a file. ... tbuch(C) 

produces a list of the soft ware modifications to the system . . . swconfig(C) 

entry points in a driver object module, routines: finds driver . . n)utines(ADM) 

Relocatable Format for Objea Modules. 86rel: Intel 8086 . . . 86rel(F) 

/ckpacct, dodisk, lastlogin, monacct, nulladm, prctmpy . . . acctsh(ADM) 

profile, monitor: Prepares execution . . . monitor(S) 

^lapstr, convkey: Configure monitor screen mapping mapkey(M) 

uusub: Monitor uucpnetworic uusub(Q 

tty [01 -/i], color, monochrome, ega,. screen: . . . screen(HW) 

mnt: Mount a filesystem mnt(C) 

fstab: File system mount and check commands. . . . fstab(F) 

mount: Mounts a file structure. . . mount(ADM) 

mount: Mounts a file system. . . . mount(S) 

mountall: mountall, umountall - mount, unmount multiple file/ . . mountaU(ADM) 

mountall: mountall, umountall mount, unmount multiple file/ . . mountall(ADM) 

mount, unmoimt multiple file/ mountall: mountall, umountall - . . mountall(ADM) 

unmount multiple file/ mountall: mountall, umountall - mount, . . . mountall(ADM) 

mnttab: Format of mounted file system table. .... mnttab(F) 

/Default information for mounting filesystems filesys(F) 

mount: Mounts a file structure mount(ADM) 

mount: Mounts a file system mount(S) 

mouse: System mouse mouse(HW) 

usemouse: Maps mouse input to keystrokes .... usemouse(C) 

mouse: System mouse mouse(HW) 

specific address, movedata: Copies bytes from a . . movedata(DOS) 

mvdir: Moves a directory mvdir(Q 

directories, mv: Moves or renames files and . . . mv(Q 

Iseek: Moves read/write file pointer. . . Iseek(S) 

utility mscreen: Serial multiscreens . . . mscreen(M) 

dosid: XENIX to MS-DOS cross linker. dosld(CP) 

msg: read mail msg(Q 

operations, msgctl: Provides message control . msgctl(S) 

msgget: Gets message queue. . . . msgget(S) 

msgop: Message operations. . . . msgop(S) 

mtune: file format mtune(F) 

umountall - mount, unmount multiple file systems /tnountaU, . mountaU(ADM) 

used by X t (7)/ xtproto: multiplexed channels protocol . . xtproto(M) 

windowing terminals xt: multiplexed tty driver for AT&T . xt(HW) 

terminals layers: layer multiplexer for windowing .... layers(C) 

select: synchronous I/O multiplexing. select(S) 

mscreen: Serial multiscreens utility mscreen(M) 

rc2: run commands performed for multiuser environment rc2(ADM) 

directories, mv: Moves or renames files and . . mv(Q 

mvdir: Moves a directory mvdir(C) 

Gets value for environment name, getenv: . . . . . . . . getenv(S) 

devnm: Identifies device name devnm(C) 

getlogin: Gets login name getlogin(S) 
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logname: Gets login name. . logname(C) 

pwd: Prints woridng directory name pwd(C) 

tty: Gets the terminal's name tty(Q 

Prints user and group IDs and names, id: id(C) 

user and group IDs and names id: print id(ADM) 

specific hard disk device names /display and remove . . . hdutil(ADM) 

ncheck: Generates names from inode numbers. . . . ncheck(ADM) 

basename: Removes directory names from pathnames basenamc(Q 

archive, dumpdir: Prints the names of files on a backup .... dumpdir(Q 

short interval, nap: Suspends execution for a . . nap(S) 

access to a resource/ waitsem, nbwaitsem: Awaits and checks . . waitsem(S) 

inode numbers, ncheck: Generates names from . . ncheck(ADM) 

network, netutil: Administers the XENIX . . netutil(ADM) 

locally and over any supported network, mmdf: routes mail . . . mmdf(ADM) 

netutil: Administers the XENIX network netutil(ADM) 

uusub: Monitor uucp network uusub(Q 

administration nlsadmin: netwoik listener service nlsadmin(ADM) 

/configuration interface for networking products strmtune: . . strmtune(ADM) 

/configuration utility for networking products strmcfg: . . stnncfg(ADM) 

XENK-style/ addxusers: add new user accounts given a . . . . addxusers(ADM) 

text file, newform: Changes the format of a . newform(Q 

group, newgrp: Logs user into a new . . newgrp(Q 

news: Print news items. news(C) 

news: Print news items news(C) 

/fetch, store, delete, firstkey, nextkey: Performs database/ . . . dbm(S) 

tables nictable: process NIC database into channel/domain nictable(ADM) 

process, nice: Changes priority of a .... nice(S) 

different priority, nice: Runs a command at a . . . niceCQ 

into channel/domain tables nictable: process NIC database . . nictable(ADM) 

nl: Adds line numbers to a file. . . nl(Q 

list, nlist: Gets entries from name . . . nlist(S) 

service administration nlsadmin: networic listener .... nlsadmin(ADM) 

nm: Prints name list lun(CP) 

hangups and quits, nohup: Runs a command immune to nohup(C) 

setjmp, longjmp: Performs a nonlocal "goto" setjmp(S) 

goodpw: Check a password for non-obviousness goodpw(ADM) 

false: Returns with a nonzero exit value false(Q 

is away rcvtrip: notifies mail sender that recipient . rcvtrip(C) 

Terminal driving tables for ruofit term: term(F) 

null: The null file null(F) 

null: The null file null(F) 

/dodisk, lastlogin, monacct, nulladm, prctmp, prdailyy .... acctsh(ADM) 

a string to a double-precision number, strtod, atof: Converts . . sutod(S) 

factor: Factor a number factor(C) 

rand, srand: Generates a random number. rand(S) 

random: Generates a random mmiber random(C) 

Generates names from inode numbers, ncheck: ncheck(ADM) 

atoi, atol: Converts ASCII to numbers, atof, atof(S) 

hard disk device major/minor numbers Alisplay ....... hdutil(ADM) 

library routines and error numbers, ^ystem services, . . . Intro(S) 

the/ /the list of major device numbers currently specified in . . majorsinuse(ADM) 
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nl: Adds line numbers to a file. nl(C) 

ultoa: Converts numbers to characters ultoa(DOS) 

itoa: Converts numbers to integers . itoa(DOS) 

numtbl: Create a numeric locale table numtbl(M) 

table, numtbl: Create a nimieric locale . numtbl(M) 

DMD terminal wtinit: object downloader for the 5620 . . wtinit(ADM) 

information for a commcm object file reloc: relocation . . . reloc(F) 

line number entries in a common object file linenum: linenum(F) 

section header for a common object file scnhdn scnhdr(F) 

size: Prints the size of an object file size(CP) 

the printable strings in an object file, strings: Rnds .... strings(CP) 

Idfcn: common object file access routines .... ldfcn(F) 

syms: common object file symbol table format . . syms(F) 

filehdr: file header for common object files filehdr(F) 

Finds ordering relation for an object library, lorden lorder(CP) 

driver entry points in a driver object module, routines: finds . . routines(ADM) 

8086 Relocatable Format for Object Modules. 86rel: Intel . . . 86rel(F) 

a process imtil a signal occurs, pause: Suspends .... pause(S) 

od: Displays files in octal format od(C) 

format, od: Displays files in octal .... od(C) 

Invokes a restricted version of. red: red(C) 

fp_oflF, fip_seg: Return offeet and segment fip_seg(DOS) 

new file or rewrites an existing one. creat: Creates a creat(S) 

and writing, sopen: Opens a file for shared reading . . sopen(DOS) 

opensem: Opens a semaphore opensem(S) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

ev_open: Opens an event queue for input. . . ev_open(S) 

writing, open: Opens file for reading or open(S) 

opensem: Opens a semaphore. . . opensem(S) 

commands performed to stop the operating system rcO:run .... rcO(ADM) 

prf: operating system profiler .... prf(HW) 

closedir: Performs directory operations. directory(S) 

msgctl: Provides message control operations msgctl(S) 

msgop: Message operations msgop(S) 

semctl: Controls semaphore operations semctl(S) 

semop: Performs semaphore operations semop(S) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

strdup: Performs string operations string(S) 

UNIX filesystems for optimal access time dcopy: copy . dcopy(ADM) 

vector, getopt: Gets option letter from argument . . . getopt(S) 

fcntl: file control options fcntl(M) 

getopt: Parses command options getopt(Q 

getoptcvt - parse command options getopts: getopts, .... getopts(C) 

stty: Sets the options for a terminal. stty(C) 

library, lorder: Finds ordering relation for an object . . lorder(CP) 

a directory, or a special or ordinary file, mlcnod: Makes . . . mknod(S) 

otar: original tape archive command . . otar(C) 

Copies file archives in and out. cpio: . cpio(C) 

dial: Establishes an out-going tenninal line/ dial(S) 

port, outp: Writes a byte to an output . . outp(DOS) 
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biifiered binary input and output, fread, fwrite: Performs . . £Fead(S) 

qjrintf: Fbrmats output cprintf(DOS) 

fjprintf, sprintf: Fbrmats output printf, printf(S) 

of assembler and link editor output a.out: Format a.out(F) 

pr: Prints files on the standard output pr(C) 

standard buffered input and output, stdio: Performs ..... stdio(S) 

flushall: Rushes all output buffers flushall(DOS) 

ecvt, fcvt, gcvt: Performs ou^ut conversions ccvt(S) 

error Kernel error output device error(M) 

tapedump: Dumps magnetic t^ to output file tapedump(C) 

/vsprintf: Prints formatted output of a varargj/ vprintf(S) 

outp: Writes a byte to an output port outp(DOS) 

parameters sysdef: output values of tunable sysdef(ADM) 

/acctdusg, accton, acctwtmp - overview of accounting and/ . . • acct(ADM) 

/acctdusg, accton, acctwtmp overview of accounting and/ . . . acct(ADM) 

purge: overwrites specified files .... purge(Q 

chown: Changes the owner and group of a file chown(S) 

chown: Changes owner ID chown(C) 

quot Summarizes file system ownership. quot(Q 

and expands files, pack, peat, unpack: Compresses . pack(Q 

instaUpkg: install package installpkg(ADM) 

interprocess commimication package. &ok: Standard stdipc(S) 

removepkg: remove installed package remove 

sadc - system activity report package sar: sar, sal, sa2 sar(ADM) 

displaypkg: display installed packages displaypkg(ADM) 

xtt: extract and print xt driver packet traces xtt(ADM) 

terminal 4014: paginator for the TEKTRONIX 4014 4014(C) 

to set value of a tunable parameter idtune: attempts . . . idtune(ADM) 

strmcfg: calculate STREAMS parameter values stnncfg(ADM) 

sysdef: output values of tunable parameters sysdef(ADM) 

system/ /adjusts tunable parameters to match idmemtune(ADM 

when adding more memory paramters to be adjusted .... memtune(F) 

Gets process, process group, and parent process IDs. /getppid: . . . getpid(S) 

getopts: getopts, getoptcvt - parse command options getopts(Q 

getopts: getopts, getoptcvt parse command options ..... getopts(Q 

getopt: Parses command options getopt(Q 

fdisk: Maintain disk partitions fdisk(ADM) 

files, hdr: Displays selected parts of executable binary .... hdr(CP) 

dialup shell password, passwd: Change login, group, or . passwd(C) 

passwd: The password file. . . . passwd(F) 

getpass: Reads a password getpass(S) 

login, group, or dialup shell password, passwd: Change . . . passwd(C) 

passwd: The password file passwd(F) 

pwcheck: Checks password file . pwcheck(C) 

new user accounts given a/ password file addxusers: add . . . addxusers(ADM) 

putpwent: Writes a password file entry putpwent(S) 

setpwent, endpwent: Gets password file entry, /getpwnam, . getpwent(S) 

getpw:Gets password for a given user ID. . . . getpw(S) 

goodpw: Check a password for non-obviousness. . . goodpw(ADM) 

paste: Merges lines of files. . . . paste(C) 

Delivers directory part of pathname, dimame: dimame(C) 
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directory, getcwd: Get the pathname of current woiking . . . getcwd(S) 

Removes directory names from pathnames, basename: basename(Q 

fgrep: Searches a file for a pattern, grep.egrep, grep(C) 

Searches for and processes a pattern in a file, awk: awk(Q 

a signal occurs, pause: Suspends a process until . . pause(S) 

pax: portable archive exchange . . pax(C) 

keyboard: The PC keyboard keyboard(HW) 

expands files, pack, peat, unpack: Compresses and . . pack(Q 

a process, popen, pdose: Initiates I/O to or from . . popen(S) 

reduction reduce: perform audit data analysis and . . reduce(ADM) 

environment rc2: run commands performed for multiuser rc2(ADM) 

system rcO: run commands perfoimed to stop the operating . . rcO(ADM) 

bsearch: Performs a binary search bsearch(S) 

setjmp, longjmp: Performs a nonlocal "goto". . . . setjmp(S) 

qsort: Rjrforms a quicker sort qsort(S) 

floor, fabs, ceil, iinod: Performs absolute value, floor^ . . floor(S) 

bessel, jO, j 1 , jn, yO, y 1 , yn: Fterforms Bessel iunctions bessel(S) 

and output, fiead, fwrite: Performs bufikred binary input . . fipead(S) 

/delete, firstkey, nextkey: Performs database functions. . . . dbm(S) 

closedir: Perfoirns directory operations. . . directory(S) 

exp, log, pow, sqrt, loglO: Performs exponential, logarithmy . exp(S) 

sinh, cosh, tanh: Performs hyperbolic fimctions. . . sinh(S) 

backup, backup: Performs incremental file system . backup(ADM) 

update. Isearch, Ifind: Performs linear search and .... lsearch(S) 

gamma: F^rfonns log gamma function. . . gamma(S) 

ecvt, fcvt, gcvt: Performs output conversions. . . . ecvt(S) 

system backups fsphoto: Performs periodic semi-automated . fsphoto(ADM) 

functions backup: performs UNIX backup backup(ADM) 

incremental filesystem/ xbackup: Performs XENIX xbackup(ADM) 

functions, curses: Performs screen and cursor . . . curses(S) 

semop: I^rfonns semaphore operations. . semop(S) 

operations, shmop: Performs shared memory .... shmop(S) 

and output, stdio: Performs standard buffered input . stdio(S) 

strdup: Performs string operations string(S) 

Agetflag, tgetstr, tgoto, tputs: Performs tenninal functions. . . . tenncap(S) 

tan, asin, acos, atan, atan2: Performs trigonometric/ /cos, . . trig(S) 

backups fsphoto: Performs periodic semi-automated system . fsphoto(ADM) 

check the uucp directories and permissions file uucheck: .... uucheck(ADM) 

permissions: Format of UUCP ftrmissions file. permissions(F) 

Permissions file, permissions: Format of UUCP . . pennissions(F) 

chmod: Changes the access permissions of a file or/ chmod(C) 

to a terminal, mesg: Permits or denies messages sent . mesg(C) 

acct: Format of per-process accounting file. . . . acct(F) 

acctcms: command summary from per-process accounting records . . acctcms(ADM) 

ermo: Sends system error/ perror, sys_erriist, sys_nerr, . . . perror(S) 

split: Splits a file into pieces split(C) 

pipe: Creates an interprocess pipe pipe(S) 

tee: Creates a tee in a pipe tee(Q 

pipe, pipe: Creates an interprocess . . . pipe(S) 

data in memory, plock: Lock process, text, or . . . plock(S) 

plot: graphics interface plot(F) 
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images pnch: file format for card .... pnch(F) 

Iseek: Moves read/write file pointer. Iseek(S) 

the current position of the file pointer, tell: Gets tell(DOS) 

rewind: Repositions a file pointer in a stream, /ftell, .... fseek(S) 

routines: finds driver entry points in a driver object/ routines(ADM) 

utility purge(Q purge: the policy file of the sanitization . . . purge(F) 

poU:FonnatofUUCP Poll file poll(F) 

poll: Format of UUCP Poll file. . . poll(F) 

queue. ev_pop: Pop the next event off the .... ev_jx)p(S) 

or from a process, popen, pclose: Initiates I/O to . . popen(S) 

outp: Writes a byte to an output port outp(DOS) 

pcu: port configuration utility .... pcu(ADM) 

setmode: port modes utility setmode(C) 

pax: portable archive exchange .... pax(C) 

tty2[A-H]: Interface to serial ports. /,ttyl[A-H],tty2[a-h], . . . serial(HW) 

pscat: ASCII-to- PostScript filter pscat(C) 

exponentiaiy exp, log, pow, sqrt, log 10: Performs .... exp(S) 

powerfail: performs power failure shutdown service . powerfail(M) 

restart: performs power failure recovery service . . restart(M) 

/Performs exponential, logarithm, power, square root functions. . . . exp(S) 

output, pr: Prints files on the standard . . pr(C) 

/lastlogin, monacct, nulladm, prctmp, prdaily, prtaccty .... acctsh(ADM) 

Anonacct, nulladm, prctmp, prdaily, prtacct, runaccty .... acctsh(ADM) 

dc: Invokes an arbitrary precision calculator. dc(C) 

monitor Prepares execution profile monitor(S) 

cpp: The C language preprocessor. cpp(CP) 

unget: Undoes a previous get of an SCCS file. . . . unget(CP) 

prf: operating system profiler . . . prf(HW) 

profiler: prfld, prfstat, prfdc, prfsnap, prfjpr -/ profiler(ADM) 

prfjpr-UNIX/ profiler: prfld, prfstat, prfdc, prfsnap, . . . pK)filer(ADM) 

/prfld, prfstat, prfdc, prfsnap, prfpr- UNIX system/ profiler(ADM) 

profiler: prfld, prfstat, prfdc, prfsnap, pr^r - UNIX/ profiler(ADM) 

-/ profiler: prfld, prfstat, prfdc, prfsnap, pr^r . . . profiler(ADM) 

lock: Locks a process in primary memory lock(S) 

grajAiical files gps: graphical primitive string, format of .... gps(F) 

types: Primitive system data types. . . . types(F) 

temporarily privs: print and/or restrict privileges . . privs(Q 

to a serial/ consoleprint: Print file to printer attached . . . consoleprint(ADM) 

news: Print news items news(C) 

infocmp: compare or print out terminfo descriptions . . infocmp(ADM) 

filters used with the LP print service /administer .... lpfilter(ADM) 

forms used with the LP print service /administer .... Ipforms(ADM) 

utility Ipsh: Menu driven Ip print service administration . . . lpsh(ADM) 

jwin: print size of layer jwin(Q 

the user's temiinal Iprint: Print to a printer attached to ... Iprint(C) 

hostid: print imique hardware ID .... hostid(ADM) 

and names id: print user and group IDs id(ADM) 

xtt: extract and print xt driver packet traces . . . xtt(ADM) 

xts: extract and print xt driver statistics xts(ADM) 

file, strings: Finds the printable strings in an object . . . suings(CP) 

pcu: printer port configuration .... pcu(ADM) 
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xprsetup: transparent printer setup utility xprsetup(ADM) 

command xprcat: transparent printer over modem line .... xprcat(0 

consoleprint: Print file to printer attached to a serial/ .... consoleprint(ADM) 

terminal Iprint: Print to a printer attached to the user's . . . lprint(C) 

lp,lpO,lpl,lp2:Line printer device interfaces lp(HW) 

xprtab: system tty transparent printer m^ file xprtab(F) 

Ibms on terminals and line printers, enable: enable(Q 

disable: IXims off terminals and printers disable(C) 

Formats output, printf, Iprintf, sprintf: printf(S) 

lpusers:set printing queue priorities Ipusers(ADM) 

cal: Prints a calendar. cal(C) 

prs: Prints an sees file pre(CP) 

sddate: Prints and sets backup dates. . . . sddate(e) 

date: Prints and sets the date date(e) 

activity, sact: Prints current SeeS file editing . . sact(CP) 

output, pr: Prints files on the standard .... pr(C) 

vprintf, vlprintf, vsprintf: Prints formatted output of a/ ... vprintf(S) 

banner: Prints large letters banner(C) 

information. Ipstat: prints lineprinter status Ipstat(C) 

nm: Prints name list nm(CP) 

file system fsname: Prints or changes the name of a . . fsname(ADM) 

acctcom: Searches for and prints process accounting files. . . acctcom(ADM) 

messages strace: Prints STREAMS trace strace(ADM) 

yes: Prints string repeatedly yes(e) 

stream, head: Prints the first few lines of a . . . head(e) 

UNIX system, uname: Prints the name of the current . . uname(C) 

backup archive, dumpdir: Prints the names of files on a . . . dumpdir(Q 

file, size: Prints the size of an object .... size(eP) 

names, id: Prints user and group IDs and . . idCQ 

pwd: Prints woricing directory name. . . pwd(C) 

Ipusers: set printing queue priorities lpusers(ADM) 

Runs a command at a different priority, nice: nice(Q 

nice: Changes priority of a process nice(S) 

privs: print and/or restrict privileges temporarily privs(Q 

privileges temporarily privs: print and/or restrict .... privs(Q 

- system initialization procedures brc: brc, bcheckrc . . brc(ADM) 

/startup, tumacct - shell procedures for accounting .... acctsh(ADM) 

Initiates I/O to or from a process, popen, pclose: popen(S) 

deliver: MMDF mail delivery process deliver(ADM) 

exit, _exit: Terminates a process exit(S) 

exit: Terminates the calling process exit(DOS) 

foric: Creates a new process foric(S) 

kill: Terminates a process killCC) 

nice: Changes priority of a process nice(S) 

ptrace: Traces a process ptrace(S) 

spawnl, spawnvp: Creates a new process spawn(DOS) 

acct: Enables or disables process accounting acct(S) 

acctprc: acctprcl, acctprc2 - process accounting acctprc(ADM) 

acctprc: acctprcl, acctprc2 process accounting acctprc(ADM) 

acctcom: Searches for and prints process accounting files acctcom(ADM) 

alarm: Sets a process' alarm clock alann(S) 
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tunes: Gets process and child process times. . times(S) 

init,inir: Process control initialization. . . . init(M) 

timex: time a command; report process data and system activity . timex(ADM) 

/getpgrp, getppid: Gets process, process group, and parent/ .... getpid(S) 

setpgrp:Sets process group ID. ....... setpgip(S) 

process group, and parent process IDs. /Gets process, ... getpid(S) 

lock: Locks a process in primary memory. . . . lock(S) 

channel/domain tables nictable: process NIC database into .... nictable(ADM) 

kill: Sends a signal to a process or a group of processes. . . kill(S) 

getpid, getpgrp, getppid: Gets process, process group, and/ . . . getpid(S) 

ps: Reports process status ps(C) 

memory. plock:Lock process, text, or data in plock(S) 

times: Gets process and child process times times(S) 

wait: Waits for a child process to stop or terminate. . . . wait(S) 

pause: Suspends a process tmtil a signal occurs. . . . pause(S) 

sigsem: Signals a process waiting on a semaphore. . sigsem(S) 

checklist: List of file systems processed by fsck. checklist(F) 

Awaits completion of background processes, wait: wait(C) 

killall: kill all active processes killall(ADM) 

to a process or a group of processes, kill: Sends a signal . . kill(S) 

awk: Searches for and processes a pattern in a file. , . . awk(Q 

shutdown: Terminates all processing shutdown(ADM) 

mailx: interactive message processing system mailx(C) 

m4: Invokes a macro processor m4(CP) 

list: list processor channel for MMDF . . list(ADM) 

machid: machid, i386 - get processor type truth value .... machid(C) 

subsystem events dlvr_audit: produce audit records for .... dlvr_audit(ADM) 

modifications to the/ swconfig: produces a list of the software . . swconfig(C) 

prof: Displays profile data prof(CP) 

prof: profile within a fimction . . prof(M) 

time profile, profil: Creates an execution . . . profil(S) 

Creates an execution time profile, profil: profil(S) 

monitor: Prepares execution profile monitor(S) 

prof: Displays profile data prof(CP) 

at login time, profile: Sets up an environment . . profile(M) 

prof: profile within a function prof(M) 

prf: operating system profiler prf(HW) 

prfpr - UMX system profiler /prfdc, prfsnap, profiler(ADM) 

prfsnap, prfpr - UNIX/ profiler: prfld, prfstat, prfdc, . . . profiler(ADM) 

assert: Helps verify validity of program assert(S) 

boot: XENIX boot program boot(HW) 

etext, edata: Last locations in program, end, end(S) 

tape: Magnetic tape maintenance program tape(Q 

ksh: standard command and programming language ksh(Q 

rksh: restricted command and programming language ksh(Q 

and regenerates groups of programs. /Maintains, updates, . . make(CP) 

cb: Beautifies C programs cb(CP) 

xref: Cross-references C programs xref(CP) 

xstr: Extracts strings from C programs xstr(CP) 

lex: Generates programs for lexical analysis. . . lex(CP) 

domain of a program promain: restrict the execution . . promain(M) 
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day. asktime: Prompts for the correct time of . . asktime(ADM) 

proto: prototype job file for at . . piDto(ADM) 

windowing terminal/ layers: protocol used between host and . . layers(M) 

xtproto: multiplexed channels protocol used by x t (7)/ .... xtproto(M) 

proto: prototype job file for at proto(ADM) 

labelit: provide labels for file systems . . labelit(ADM) 

locking on files, lockf: Provide semaphores and record . . lockf(S) 

operations, msgctl: Provides message control .... msgctl(S) 

prs: Prints an sees file prs(CP) 

AiuUadm, prctmp, prdaily, prtacct, runacct, shutaccty .... acctsh(ADM) 

ps: Reports process status ps(Q 

sxt: fteudo-device driver. sxt(M) 

information, pstat: Reports system pstat(Q 

ptrace: IVaces a process ptrace(S) 

files purge: overwrites specified . . . puige(Q 

sanitization utility purge(Q purge: the policy file of the . . . purge(F) 

file of the sanitization utility purge(C) purge: the policy . . . purge(F) 

stream, ungetc: Pushes character back into input . ungetc(S) 

a character or word on a/ putc, putchar, Iputc, putw: Puts . . putc(S) 

console, putch: Writes a character to the . . putch(DOS) 

character or word on a/ putc, putchar, fputc, putw: Puts a . . . putc(S) 

environment, putenv: Changes or adds value to . putenv(S) 

entry, putpwent: Writes a password file . putpwent(S) 

putc, putchar, fputc, putw: Puts a character or word on a/ . . putc(S) 

puts, fputs: Puts a string on a stream puts(S) 

cputs: Puts a string to the console. . . . cputs(DOS) 

stream, puts, fputs: Puts a string on a . . . puts(S) 

on a/ putc, putchar, fputc, putw: Puts a character or word . . putc(S) 

pwcheck: Checks password file. . pwcheck(C) 

name, pwd: Prints woridng directory . . pwd(C) 

tapecnfl: AT&T tape control for QIC-24/QIC-02 tape device . . . tapecntl(C) 

qsort: Performs a quicker sort. . . qsort(S) 

tput: Queries the terminfo database. . . tput(C) 

Plop the next event off the queue. ev_pop: ev_jX)p(S) 

Read the next event in the queue. ev_read: ev_re^(S) 

all events currently in the queue. ev_flush: Discard .... ev_flush(S) 

ev_resume: Restart a suspended queue ev_resume(S) 

ev_suspend: Suspends an event queue ev_susp(S) 

list of devices feeding an event queue. ev_getdev: Gets a .... ev_getdev(S) 

msgget: Gets message queue msgget(S) 

of events currently in the queue. /Returns the number . . . ev_count(S) 

ev_close: Qose the event queue and all associated/ .... ev_close(S) 

ev_block: Wait until the queue contains an event .... ev_block(S) 

transit queue: MMDF queue files for storing mail in . . . queue(ADM) 

ev_open: Opens an event queue for input ev_open(S) 

storing mail in transit queue: MMDF queue files for . . queue(ADM) 

Ipusers: set printing queue priorities lpusers(ADM) 

ipcrm: Removes a message queue, semaphore set or shared/ . ipcnn(ADM) 

checkque: MMDF queue status report generator . . . checkque(ADM) 

qsort: Performs a quicker sort qsort(S) 

a command immune to hangups and quits. nohup:Runs nohup(Q 
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ownership, quot: Summarizes file system . . . quot(Q 

number, rand, srand: Generates a random . rand(S) 

number, random: Generates a random . . . random(C) 

ranlib: Converts archives to random libraries ranlib(CP) 

rand, srand: Generates a random number. rand(S) 

random: Generates a random number. random(C) 

random libraries, ranlib: Converts archives to . . . ranlib(CP) 

FORTRAN into standard FORTRAN, ratfor: Converts Rational .... ratfor(CP) 

FORTRAN, ratfor. Converts Rational FORTRAN into standard . ratfor(CP) 

stop the operating system rcO: run commands performed to . rcO(ADM) 

multiuser envirormient rc2: run commands performed for . rc2(ADM) 

systems, rep: Copies files across XENIX . . rcp(Q 

data to be read, rdchk: Checks to see if there is . . rdchk(S) 

to see if there is data to be read, rdchk: Checks rdchk(S) 

generated by the audit/ auditd: read audit collection files .... auditd(ADM) 

in a file, getdents: read directory entries and put . . . getdents(S) 

specifications idmkinit: read files containing idmkinit(ADM) 

setlocale: Set or read international environment . . setlocale(S) 

msg: read mail msg(C) 

read: Reads from a file read(S) 

informatioa hwconfig: Read the configuration hwconfig(ADM) 

queue. ev_read: Read the next event in the .... ev_read(S) 

sopen: Opens a file for shared reading and writing sopen(DOS) 

open: Opens file for reading or writing open(S) 

orxmlocks a file region for reading or writing. /Locks .... locking(S) 

getpass: Reads a password getpass(S) 

defopen, defread: Reads default entries defopen(S) 

read: Reads from a file read(S) 

line: Reads one line line(Q 

mail: Sends, reads or disposes of mail mail(Q 

Iseek: Moves read/write file pointer. lseek(S) 

memory, malloc, free, realloc, calloc: Allocates main . . malloc(S) 

getclk: gets string from real-time clock getclk(M) 

clock: The system real-time (time of day) clock. . . . clock(F) 

setclock: Sets the system real-time (time of day) clock. . . . setclock(ADM) 

systems and shuts down/ haltsys, reboot: Qoses out the file .... haltsys(ADM) 

vdutil: rebuild a mirrored disk vdutil(ADM) 

Specifies what to do upon receipt of a signal, signal: .... signal(S) 

rmail: submit remote mail received via UUCP rmail(ADM) 

lineprinters. Ipinit: Adds, reconfigures and maintains .... Ipinit(ADM) 

lockf: Provide semaphores and record locking on files lockf(S) 

from per-process accounting records /command summary . . . acctcms(ADM) 

manipulate coimect accoimting records fwtmp: fwtmp, wtmpfix: . fwtmp(ADM) 

dlvr_audit: produce audit records for subsystem events . . . dlvr_audit(ADM) 

performs power failure recovery service restart(M) 

version of. red: Invokes a restricted red(C) 

analysis and reduction reduce: perform audit data .... reduce(ADM) 

perform audit data analysis and reduction reduce: reduce(ADM) 

regular expressions, regex, regcmp: Compiles and executes . . regex(S) 

expressions, regcmp: Compiles regular .... regcmp(CP) 

make: Maintains, updates, and regenerates groups of programs. . make(CP) 
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executes regular expressions, regex, rcgcmp: Compiles and . . . regex(S) 

compile and match routines, regexp: Regular expression . . . regexp(S) 

execseg: makes a data region executable execseg(S) 

locking: Locks or unlocks a file region for reading or writing. . . . locking(S) 

match routines, regexp: Regular expression compile and . regexp(S) 

regcmp: Compiles and executes regular expressions, regex, . . . regex(S) 

regcmp: Compiles regular expressions regcmp(CP) 

sorted files, comm: Selects or rejects lines common to two . . . comm(Q 

intro: Introduction to machine related miscellaneous features/ . . Intro(HW) 

lorden Finds ordering relation for an object library. . . . lorder(CP) 

join: Joins two relations. . join(C) 

for a common object file reloc: relocation information . . . reloc(F) 

Modules. 86rel: Intel 8086 Relocatable Fbrmat for Objea . . 86rel(F) 

strip: Removes symbols and relocation bits strip(CP) 

common object file reloc: relocation information for a ... reloc(F) 

show current layer relogin: rename login entry to . . relogin(ADM) 

value, floor, ceiling and remainder functions, /absolute . . floor(S) 

calendar Invokes a reminder service calendar(C) 

remote XENIX system, remote: Executes commands on a . remote(C) 

rmail: submit remote mail received via UUCP . nnail(ADM) 

uutry: try to contact remote system with debugging on . uutry(ADM) 

ct: spawn getty to a remote terminal ct(C) 

uux: Executes command on remote XENIX uux(Q 

remote: Executes commands on a remote XENIX system remote(C) 

del.vd: remove a virtual disk del.vd(ADM) 

file rmb: remove extra blank lines from a . . nnb(M) 

removepkg: remove installed package .... removepkg(ADM) 

configuration/ idaddld: add or remove line disciplines from kernel idaddld(ADM) 

directories specified cleantmp: remove temporary files in .... cleantmp(ADM) 

package removepkg: remove installed . . . removepkg(ADM) 

file, rmdel: Removes a delta from an SCCS . . rmdel(CP) 

semaphore set or shared/ ipcrm: Removes a message queue, . . . ipcrm(ADM) 

rmdir: Removes directories rmdir(C) 

unlink: Removes directory entry unlink(S) 

pathnames, basename: Removes directory names from . . basename(Q 

rm, rmdir. Removes files or directories. . . . rm(C) 

bits, strip: Removes symbols and relocation . strip(CP) 

device names/ removing specific hard disk . . . hdutil(ADM) 

current layer relogin: rename login entry to show . . . relogin(ADM) 

directory, rename: renames a file or .... rename(DOS) 

rename: renames a file or directory rename(DOS) 

mv: Moves or renames files and directories. . . . mv(Q 

mirrored disk vdutil: repair bad block on a vdutil(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

imiq: Reports repeated lines in a file uniq(Q 

yes: Prints string repeatedly yes(C) 

fsstat: report file system status fsstat(ADM) 

checkque: MMDF queue status report generator checkque(ADM) 

blocks, df: Report number of free disk .... df(C) 

sa2, sadc - system activity report package sar: sar, sal, . . . sar(ADM) 

activity timex: time a command; report process data and system . , timex(ADM) 
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clock: Reports CPU time used clock(S) 

cmchk: Reports hard disk block size. . . . cmchk(C) 

ps: Reports process status. ..... ps(Q 

file, uniq: Reports repeated lines in a .... uniq(Q 

pstat: Reports system infortnatioa . . . pstat(Q 

inter-process/ ipcs: Reports the status of ipcs(ADM) 

vmstat: Reports virtual memory statistics. . vmstat(C) 

stream, fseek, ftell, rewind: Repositions a file pointer in a ... fseek(S) 

Starts/stops the lineprinter request. Apshut, Ipmove: .... Ipsched(ADM) 

Ip, cancel: Send/cancel requests to lineprinter. lp(C) 

terminal jterm: reset layer of windowing .... jterm(C) 

/Awaits and checks access to a resource govemed by a/ waitsem(S) 

ev_resume: Restart a suspended queue. . . . ev_resume(S) 

vdutil: restart I/O on a mirrored disk . . vdutil(ADM) 

incremental file/ restore, restor: Invokes restore(ADM) 

incremental filesystem backup restore /AT&T UNIX restore(ADM) 

incremental filesystem backup/ restore: AT&T UNIX restore(ADM) 

Invokes incremental file system/ restore, restor: restore(ADM) 

Invokes incremental file system restorer, /restor: restore(ADM) 

incremental file system restorer. /Invokes XENIX .... xrestore(ADM) 

privs: print and/or restrict privileges temporarily . . privs(C) 

a program promain: restrict the execution domain of . . promain(M) 

programming language rksh: restricted command and ksh(C) 

interpreter), rsh: Invokes a restricted shell (command .... rsh(C) 

red: Invokes a restricted version of. red(Q 

fip_off, fp_seg: Return offiet and segment fip_seg(DOS) 

ev_getemask: Retum the current event mask. . . ev_gtemsk(S) 

ismpx: retum windowing terminal state . ismpx(C) 

Stat: Data returned by stat system call. . . . stat(F) 

inp: Returns a byte inp(DOS) 

console buffer, ungetch: Returns a character to the .... ungetch(DOS) 

value, abs; Returns an integer absolute ... abs(S) 

idcheck: returns selected information . . . idcheck(ADM) 

long integer, labs: Returns the absolute value of a . . labs(DOS) 

strlen: Returns the length of a string. . . strlen(DOS) 

currently in the/ ev_count: Returns the number of events . . . ev_covmt(S) 

value, false: Returns with a nonzero exit . . . false(Q 

true: Returns with a zero exit value. . . true(C) 

col: Filters reverse linefeeds col(C) 

in a string, strrev: Reverses the order of characters . strrev(DOS) 

pointer in a/ fseek, ftell, rewind: Repositions a file .... fseek(S) 

creat: Creates a new file or rewrites an existing one creat(S) 

programming language ricsh: restricted command and . . ksh(Q 

directories, rm, rmdir: Removes files or ... rm(C) 

received via UUCP rmail: submit remote mail .... rmail(ADM) 

from a file rmb: remove extra blank lines . . rmb(M) 

sees file, rmdel: Removes a delta from an . rmdel(CP) 

rmdir: Deletes a directory rmdir(DOS) 

rmdir: Removes directories. . . . rmdir(C) 

directories, rm, rmdir: Removes files or nn(C) 

chroot: Changes the root directory chroot(S) 
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chnx)t: Changes root directory for command. . . . chroot(ADM) 

logarithm, power, square root functions, /exponential, . . . exp(S) 

supported network, mmdf: routes mail locally and over any . mmdf(ADM) 

expression compile and match routines, regexp: Regular .... regexp(S) 

Idfcn: common object file access routines ldfcn(F) 

/system services, library routines and error numbers. . . . Intro(S) 

points in a driver objecV routines: finds driver entry .... iDutines(ADM) 

/a XENIX-style UUCP routing file to MMDF/ uulist(ADM) 

/converts a XENIX-style Micnet routing file to MMDF/ mnlist(ADM) 

/hashed database of alias and routing informatioa dbmbuild(ADM) 

(command interpreter), rsh: Invokes a restricted shell . . . rsh(C) 

rtc: real time clock interface . . . rtc(HW) 

multiuser environment rc2: run commands performed for . . . rc2(ADM) 

the operating system rcO: run commands performed to stop . rcO(ADM) 

runacct: run daily accounting runacct(ADM) 

runacct: run daily accounting . . . runacct(ADM) 

4)rctmp, prdaily, prtacct, runacct, shutacct, startups .... acctsh(ADM) 

priority, nice: Runs a command at a different . . nice(C) 

and quits, nohup: Runs a command immune to hangups nohup<C) 

activity report/ sar: sar, sal, sa2, sadc - system sar(ADM) 

report package sar: sar, sal, sa2, sadc - system activity .... sar(ADM) 

editing activity, sact: Prints current SCCS file ... sact(CP) 

package sar: sar, sal, sa2, sadc - system activity report . . . sar(ADM) 

sag: system activity graph .... sag(ADM) 

purge: the policy file of the sanitization utility purge(Q . . . purge(F) 

activity report package sar: sar, sal, sa2, sadc -system .... sar(ADM) 

system activity report package sar. sar, sal, sa2, sadc - sar(ADM) 

space allocation, sbrk, brie: Changes data segment . sbric(S) 

woric. uucico: Scan the spool directory for . . . uucico(C) 

and formats input, scanf, fscanf, sscanf: Converts . . scanf(S) 

bfs: Scans big files bfs(C) 

creates bad track/ badtric: Scans fixed disk for flaws and . . badtric(ADM) 

help: Asks for help about SCCS commands help(CP) 

the delta commentary of an SCCS delta, cdc: Changes .... cdc(CP) 

comb: Combines SCCS deltas comb(CP) 

Compares two versions of an SCCS file, sccsdiflf: sccsdi£B;CP) 

Makes a delta (change) to an SCCS file, delta: delta(CP) 

Undoes a previous get of an SCCS file, unget: unget(CP) 

prs: Prints an SCCS file prs(CP) 

rmdel: Removes a delta from an SCCS file rmdel(CP) 

sccsfile: Format of an SCCS file sccsfile(F) 

val: Validates an SCCS file val(CP) 

sact: Prints current SCCS file editing activity sact(CP) 

admin: Creates and administers SCCS files admin(CP) 

of an SCCS file, sccsdiffi Compares two versions . sccsdif8[CP) 

file, sccsfile: Format of an SCCS . . . sccsfile(F) 

system backups schedule: Database for automated . schedule(ADM) 

transport program uusched: ttie scheduler for the uucp file .... uusched(ADM) 

common object file scnhdr: section header for a ... scnhdr(F) 

screen image file. scr_dump: format of curses . . . scr_dump(F) 

clear: Gears a terminal screen clear(C) 
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curses: Performs screen and cursor functions. . . . curses(S) 

setcolor: Set screen color. setcolor(C) 

scr_dump: foimat of curses screen image file scr_dump(F) 

convkey: Configure monitor screen mapping, /mapstr mapkey(M) 

color, monochrome, ega,. screen: tty [01 -n], screen(HW) 

vi, view, vedit: Invokes a screen-oriented display editor. . . vi(C) 

XENIX installation shell script xinstall: xinstall(ADM) 

install: Installation shell script install(M) 

scsinfo: display current SCSI device information .... scsinfo(ADM) 

scsinfo: display current SCSI hard disk information . . . scsinfo(ADM) 

interface, scsi: Small computer systems . . . scsi(HW) 

scsinfo: display current SCSI tape drive information . . . scsinfo(ADM) 

sdb: Invokes symbolic debugger. . sdb(CP) 

dates, sddate: Prints and sets backup . . sddate(C) 

access to a shared data/ sdenter, sdleave: Synchronizes . . sdenter(S) 

sdevice: file format sdevice(F) 

shared data segment, sdget, sdfree: Attaches and detaches a . . sdget(S) 

detaches a shared data segment, sdget, sdfree: Attaches and . . . sdget(S) 

shared data access, sdgetv, sdwaitv: Synchronizes . . sdgetv(S) 

side-by-side, sdiff: Compares files sdifiB^C) 

a shared data segment, sdenter, sdleave: Synchronizes access to . sdenter(S) 

data access, sdgetv, sdwaitv: Synchronizes shared . . sdgetv(S) 

bsearch: Performs a binary search bsearch(S) 

Isearch, Ifind: Performs linear search and update Isearch(S) 

hcreate, hdestroy: Manages hash search tables, hsearch, hsearch(S) 

tdelete, twalk: Manages binary search trees, tsearch, tfind, . . . tsearch(S) 

grep, egrep, fgrep: Searches a file for a pattern. . . . grep(C) 

accounting files, acctcom: Searches for and prints process . . acctcom(ADM) 

pattern in a file, awk: Searches for and processes a . . . awk(Q 

object file scnhdr: section header for a common . . . scnhdr(F) 

getty initcond: special security actions for init and . . . initcond(ADM) 

description subsystem: security subsystem component . . subsystem(M) 

sed: Invokes the stream editor. . . sed(C) 

uniformly distributed. srand48, seed48, lcong48: Generates . . . drand48(S) 

access to a shared data segment /sdleave: Synchronizes . sdenter(S) 

and detaches a shared data segment /sdfree: Attaches . . . sdget(S) 

bricctl: Allocates data in a far segment bikctl(S) 

fip_seg: Return offeet and segment. ^_off, fp_seg(DOS) 

shmget: Gets a shared memory segment shmget(S) 

sbik, bik: Changes data segment space allocation sbric(S) 

segread: command description. . . segread(DOS) 

multiplexing, select: synchronous I/O select(S) 

greek: select terminal filter greek(C) 

a file, cut: Cuts out selected fields of each line of . . . cut(C) 

idcheck: returns selected information idcheck(ADM) 

binary files, hdr: Displays selected parts of executable . . . hdr(CP) 

to two sorted files, comm: Selects or rejects lines common . . comm(C) 

Creates an instance of a binary semaphore, creatsem: creatsem(S) 

Signals a process waiting on a semaphore, sigsem: sigsem(S) 

opensem: Opens a semaphore opensem(S) 

to a resource governed by a semaphore, /and checks access . . waitsem(S) 
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semctl: Controls semaphore operations semctl(S) 

semop: Performs semaphore operations semop(S) 

ipcrm: Removes a message queue, semaphore set or shared memory. . ipcnn(ADM) 

semget: Gets set of semaphores semget(S) 

files, lockf: Provide semaphores and record locking on . lockf(S) 

operations, semctl: Controls semaphore . . . semctl(S) 

semget: Gets set of semaphores. . semget(S) 

fsphoto: Performs periodic semi-automated system backups . fsphoto(ADM) 

operations, semop: Performs semaphore . . . semop(S) 

hello: Send a message to another user. . . hello(ADM) 

lineprinter. Ip, cancel: Send/cancel requests to lp(Q 

away rcvtrip: notifies mail sender that recipient is rcvtiip(C) 

group of processes, kill: Sends a signal to a process or a . . kill(S) 

mail, mail: Sends, reads or disposes of .... m^l(Q 

/sys_errlist, sys_nerr, ermo: Sends system error messages. . . perror(S) 

mesg: Permits or denies messages sent to a terminal mesg(C) 

file to printer attached to a serial console /Print consoleprint(ADM) 

mscreen: Serial multiscreens utility .... mscreen(M) 

,tty2[A-H]: Interface to serial ports. /, tty2[a-h] serial(HW) 

calendar: Invokes a reminder service calendar(C) 

error/ intro: Introduces system services, library routines and . . . Intro(S) 

disable auditing for the next session chg_audit: enables and . . chg_audit(ADM) 

Map of the ASai character set. ascii: ascii(M) 

pcu: set port configuration pcu(ADM) 

buflfering to a stream, setbuf, setvbuf: Assigns setbuf(S) 

real-time (time of day) clock, setclock: Sets the system .... setclock(ADM) 

setcolor Set screen color. .... setcolor(C) 

setuid, setgid: Sets user and group IDs. . . setuid(S) 

getgrent, getgrgid, getgmam, setgrent, endgrent: Get group/ . . getgrent(S) 

nonlocal "goto", setjmp, longjmp: Performs a . . . setjmp(S) 

keys. seUcey: Assigns the function . . . seticey(C) 

international environment setlocale: Set or read setlocale(S) 

table, setmnt: Establishes /etc/mnttab . . setmnt(ADM) 

setmode: Sets translation mode. . . setmode(DOS) 

setpgrp: Sets process group ID. . . setpgrp(S) 

getpwent, getpwuid, getpwnam, setpwent, endpwent: Gets/ .... getpwent(S) 

trchan: Translate character sets trchan(M) 

alarm: Sets a process' alarm clock. . . . alarm(S) 

to one charater. strset: Sets all characters in a string . . . strset(DOS) 

mask, umask: Sets and gets file creation .... umask(S) 

sddate: Prints and sets backup dates sddate(C) 

execution, env: Sets environment for command . . env(C) 

ev_setemask: Sets event mask ev_stemsk(S) 

modification times, utime: Sets file access and utime(S) 

umask: Sets file-creation mode mask. . . umask(Q 

setpgrp: Sets process group ID setpgrp(S) 

tset: Sets terminal modes tset(Q 

speed, and line/ getty: Sets terminal type, modes, .... getty(M) 

base, cmos: Displays and sets the configuration data .... cmos(HW) 

date: Prints and sets the date date(C) 

a video device, vidi: Sets the font and video mode for . vidi(C) 
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stty: Sets the options for a tenninal. . . stty(C) 

of day) clock, setclock: Sets the system real-time (time . . setclock(ADM) 

sdme: Sets the time stime(S) 

setmode: Sets translation mode. setmode(DOS) 

time, profile: Sets up an environment at login . . profile(M) 

setuid, setgid: Sets user and group IDs setuid(S) 

ulimit: Gets and sets user limits ulimit(S) 

modificaticn dates of files, settime: Changes the access and . settime(ADM) 

"gettydefs: Speed and terminal" 

group IDs. setuid, setgid: Sets user and ... setuid(S) 

xprsetup: transparent printer setup utility xprsetup(ADM) 

stream, setbuf, setvbuf: Assigns buffering to a . . setbuf(S) 

sfsys: file format. ....... sfsys(F) 

(F) sfsys: file format. sfsys 

data in a/ spud, sgetl: Accesses long integer . . . sputl(S) 

interpreter, sh: Invokes the shell command . . sh(C) 

sdgetv, sdwaitv: Synchronizes shared data access sdgetv(S) 

Synchronizes access to a shared data segment. /sdleave: . . sdenter(S) 

sdfree: Attaches and detaches a shared data segment, sdget, . . . sdget(S) 

message queue, semaphore set or shared memory, ipcrm: Removes a ipcrm(ADM) 

shmctl: Controls shared memory operations. . . . shmctl(S) 

shmop: Performs shared memory operations. . . . shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

sopen: Opens a fUe for shared reading and writing. . . . sopen(DOS) 

system: Executes a shell command system(S) 

rsh: Invokes a restricted shell (command interpreter). . . . rsh(C) 

sh: Invokes the shell command interpreter. .... sh(Q 

C-like syntax, csh: Invokes a shell command interpreter with . . csh(C) 

shl: Shell layer manager. shl(Q 

Change login, group, or dialup shell password, passwd: .... passwd(C) 

/shutacct, startup, tumacct shell procedures for/ acctsh(ADM) 

/shutacct, startup, tumacct - shell procedures for accounting . . acctsh(ADM) 

install: Installation shell script install(M) 

xinstall: XENIX installation shell script xinstall(ADM) 

shl: Shelllayer manager. .... shl(C) 

operations, shmctl: Controls shared memory . shmctl(S) 

segment, shmget: Gets a shared memory . . shmget(S) 

operations, shmop: Performs shared memory . shmop(S) 

nap: Suspends execution for a short interval nap(S) 

^rdaily, prtacct, runacct, shutacct, startup, tumacct -/ ... acctsh(ADM) 

halts the CPU. shutdn: Flushes block I/O and . . shutdn(S) 

performs power failure shutdown service ....... powerfail(M) 

processing, shutdown: Terminates all .... shutdown(ADM) 

Qoses out the file systems and shuts down the system, /reboot: . haltsys(ADM) 

sdiffi Compares files side-by-side sdifl^C) 

what to do upon receipt of a signal, signal: Specifies ..... signal(S) 

Suspends a process until a signal occurs, pause: pause(S) 

upon receipt of a signal, signal: Specifies what to do ... signal(S) 

of processes, kill: Sends a signal to a process or a group . . . kill(S) 

gsignal: Implements software signals, ssignal, ssignal(S) 

semaphore, sigsem: Signals a process waiting on a . . sigsem(S) 
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waiting on a semaphore, sigsem: Signals a ptxicess .... sigsem(S) 

atan2: Performs trigonometric/ sin, cos, tan, asin, acos, atan, . . . trig(S) 

sulogin: access single-user mode sulogin(ADM) 

hyperbolic functions, sinh, cosh, tanh: Performs .... sinh(S) 

cmchk: Reports hard disk block size cmchk(C) 

chsize: Changes the size of a file chsize(S) 

size: Prints the size of an object file size(CP) 

jwin: print size of layer jwin(Q 

object file, size: Prints the size of an .... size(CP) 

interval, sleep: Suspends execution for an . sleep(C) 

interval, sleep: Suspends execution for an . sleep(S) 

current/ ttyslot: Finds the slot in the utmp file of the .... ttyslot(S) 

checker smmck: trusted computing base . tcbck(ADM) 

spline: Interpolates smooth curve spline(CP) 

swconfig: produces a list of the software modifications to the/ . . swconfig(C) 

ssignal, gsignal: Implements software signals ssignal(S) 

reading and writing, sopen: Opens a file for shared . . sopen(DOS) 

qsort: Performs a quicker sort qsort(S) 

sort: Sorts and merges files. . . . sort(Q 

or rejects lines common to two sorted files, comm: Selects . . . comm(Q 

tsort: Sorts a file topologically tsort(CP) 

sort: Sorts and merges files sort(Q 

an error message file from C source, mkstr: Creates mkstr(CP) 

idspace: investigates free space idspace(ADM) 

sbric, bik: Changes data segment space allocation sbik(S) 

ct: spawn getty to a remote terminal . ct(C) 

process, spawnl, spawnvp: Creates a new . spawn(DOS) 

spawnl, spawnvp: Creates a new process. . spawn(DOS) 

movedata: Copies bytes from a specific address movedata(DOS) 

sysi86: machine specific functions sysi86(S) 

fspec: format specification in text files .... fspecCF) 

idmkinit: read files containing specifications idmkinit(ADM) 

temporary files in directories specified cleantmp: remove . . . cleantmp(ADM) 

purge: overwrites specified files purge(Q 

/the list of vectors currently specified in the sdevice/ vectorsinuse(ADM) 

Anajor device numbers currently specified in the mdevice file . . . majorsinuse(ADM) 

cron: Executes commands at specified times cron(0 

receipt of a signal, signal: Specifies what to do upon .... signal(S) 

/Sets terminal type, modes, speed, and line discipline getty(M) 

/set terminal type, modes, speed, and line discipline .... uugetty(ADM) 

by getty. "gettydefs:" Speed and teraiinal settings used . gettydefs(F) 

hashcheck: Finds spelling/ spell, hashmake, spellin, .... spell(Q 

spelling/ spell, hashmake, spellin, hashcheck: Finds .... spell(Q 

spellin, hashcheck: Finds spelling errors, /hashmake, . . . spell(C) 

curve, spline: Interpolates smooth . . . spline(CP) 

pieces, split: Splits a file into split(C) 

split: Splits a file into pieces split(C) 

context, csplit: Splits files according to csplit(C) 

into a/ frexp, Idexp, modf: Splits floating-point number . . . frexp(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

uucico: Scan the spool directory for woric uucico(C) 
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Configures the lineprinter spooling system. Ipadmiii: .... Ipadmin(ADM) 

printf, fjprintf, sprintf: Fonnats output printf(S) 

integer data in a/ sputl. sgetl: Accesses long .... sputl(S) 

exponentiaiy exp, log, pow, sqrt, loglO: Perfonns exp(S) 

exponential, logarithm, power, square root functions. /Performs . exp(S) 

number, rand, srand: Generates a random .... rand(S) 

Generates uniformly/ srand48, seed48, lcong48: .... drand48(S) 

input, scanf, fscanf, sscanf: Converts and fonnats . . . scanf(S) 

software signals, ssignal, gsignal: Implements . . . ssignal(S) 

output, stdio: Performs standard buffered input and . . . stdio(S) 

Converts Rational FORTRAN into standard FORTRAN, ratfor: . . . ratfor(CP) 

gets: Gets a string from the standard input gets(CP) 

communication package, ftok: Standard interprocess stdipc(S) 

pr: Prints files on the standard output pr(C) 

Ipsched, Ipshut, Ipmove: Starts/stops the lineprinter/ .... Ipsched(ADM) 

4)rtacct, runacct, shutacct, startup, tumacct - shell/ acctsh(ADM) 

system call, stat: Data returned by stat .... stat(F) 

Stat, fstat: Gets file status stat(S) 

stat: Data returned by stat system caU stat(F) 

information, statfs: get file system statfs(S) 

ustat: Gets file system statistics ustat(S) 

xts: extract and print xt driver statistics xts(ADM) 

virtual memory statistics, vmstat: Reports .... vmstat(C) 

fileno: Determines stream status, ferror, feof, clearerr, . . . ferror(S) 

fsstat: report file system status fsstat(ADM) 

ps: Reports process status ps(Q 

stat, fstat: Gets file status stat(S) 

Ipstat: prints lineprinter status information Ipstat(C) 

uustat: uucp status inquiry and job control. . . uustat(C) 

communication/ ipcs: Reports the status of inter-process ipcs(ADM) 

checkque: MMDF queue status report generator checkque(ADM) 

buffered input and output, stdio: Performs standard stdio(S) 

stime: Sets the time stime(S) 

Waits for a child process to stop or terminate, wait: wait(S) 

rcO: run commands performed to stop the operating system .... rcO(ADM) 

compress: Compress data for storage compress(C) 

nextkey:/ dbminit, fetch, store, delete, firstkey, dbm(S) 

xmcompress: Uncompress a stored file compress(C) 

zcat: Display a stored file compress(C) 

queue: MMDF queue files for storing mail in transit queue(ADM) 

trace messages strace: Prints STREAMS strace(ADM) 

logger cleanup program strclean: STREAMS error .... strclean(ADM) 

operations, strdup: Perfonns string string(S) 

Gets a character from a stream, fgetc, fgetchar: fgetc(DOS) 

Gets character or word from a stream, /getchar, fgetc, getw: . . getc(S) 

Prints the first few lines of a stream, head: head(Q 

Pushes character back into input stream, ungetc: ungetc(S) 

Puts a character or word on a stream, ^utchar, fjputc, putw: . . putc(S) 

Repositions a file pointer in a stream, fseek, ftell, rewind: . . . fseek(S) 

fflush: Closes or flushes a stream, fclose, fclose(S) 

fgets: Gets a string from a stream, gets, gets(S) 
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fopen, freopen, fdopen: Opens a stream fopen(S) 

fiputchar: Write a character to a stream, fputc, fputc(DOS) 

puts, fputs: Puts a string on a stream puts(S) 

setvbuf: Assigns buffering to a stream, setbuf, setbuf(S) 

Invokes the stream editor, sed: sed(C) 

clearerr, fileno: Determines stream status, ferror, feof, .... ferror(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

cleanup program strclean: STREAMS error logger strclean(ADM) 

daemon strerr: STREAMS error logger strerr(ADM) 

strace: Prints STREAMS trace messages .... strace(ADM) 

fornetworicing/ strmtune: STREAMS configuration interface . strmtune(ADM) 

strmcfg: STREAMS configuration utility . . strmcfg(ADM) 

strmcfg: STREAMS parameter calculated . strmcfg(ADM) 

logger daemon strerr: STREAMS error strerr(ADM) 

string strftime: format date/time .... strftime(S) 

cgets: Gets a string cgets(DOS) 

strftime: format date/time string strftime(S) 

strlen: Returns the length of a string strlen(DOS) 

the order of characters in a string, strrev: Reverses strrev(DOS) 

files gps: graphical primitive string, format of graphical .... gps(F) 

gets, fgets: Gets a string from a stream gets(S) 

getclk: gets string from real-time clock .... getclk(M) 

gets: Gets a string from the standard input. . . gets(CP) 

puts, Iputs: Puts a string on a stream puts(S) 

strdup: Performs string operations string(S) 

yes: Prints string repeatedly yes(C) 

strtod, atof: Converts a string to a double-precision/ • • . strtod(S) 

strtol, atol, atoi: Converts string to integer strtol(S) 

strset: Sets all characters in a string to one charater strset(DOS) 

cputs:Putsa string to the console cputs(DOS) 

strings in an object file, strings: Finds the printable .... strings(CP) 

xstr: Extracts strings from C programs xstr(CP) 

strings: Finds the printable strings in an object file. ..... strings(CP) 

relocation bits, strip: Removes symbols and . . . strip(CP) 

add.vd: add a striped (virtual) disk add.vd(ADM) 

del.vd: delete a striped (virtual) disk del.vd(ADM) 

vdinfo: display striped (virtual) disk information . vdinfo(ADM) 

string, strlen: Returns the length of a . . strlen(DOS) 

characters to lowercase, strlwr: Converts uppercase .... strlwr(DOS) 

characters in a string, strrev: Reverses the order of ... strrev(DOS) 

string to one charater. strset: Sets all characters in a ... strset(DOS) 

to a double-precision number, strtod, atof: Converts a string . . . strtod(S) 

string to integer, strtol, atol, atoi: Converts .... strtol(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

characters to uppercase, strupr: Converts lowercase .... strupr(DOS) 

terminal, stty: Sets the options for a .... stty(C) 

stune: file format stune(F') 

(F) stune: file format stune 

or another user, su: Makes the user a super-user . . su(Q 

submit: MMDF mail enqueuer . . submit(ADM) 
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UUCP imail: submit remote mail received via . rmail(ADM) 

/checks for mail which has been submitted but not delivered . . . checkmail(C) 

interface for authorization subsystem /administrator .... authtsh(ADM) 

command interface for audit subsystem activationy auditcmd: . auditcmd(ADM) 

files generated by the audit subsystem and /audit collection . auditd(ADM) 

subsystem: security subsystem component description . subsystem(M) 

produce audit records for subsystem events dlvr_audit: . . dlvr_audit(ADM) 

audit: audit subsystem interface device . . . audit(ADM) 

component description subsystem: security subsystem . . subsystem(M) 

sulogin: access single-user mode . sulogin(ADM) 

counts blocks in a file, sum: Calculates checksum and . . sum(Q 

du: Summarizes disk usage du(C) 

ownership, quot: Summarizes file system quot(Q 

accounting/ acctcms: command summary from per-process .... acctcms(ADM) 

sync: Updates the super-block sync(ADM) 

sync: Updates the super-block sync(S) 

su: Makes the user a super-user or another user. .... su(C) 

keyboard mode or test keyboard support kbmode: Set kbmode(ADM) 

routes mail locally and over any supported network, mmdf: . . . mmdf(ADM) 

terminals: List of supported terminals terminals(M) 

ev_resume: Restart a suspended queue ev_resume(S) 

signal occurs, pause: Suspends a process until a . . . . pause(S) 

ev_suspend: Suspends an event queue ev_susp(S) 

interval, nap: Suspends execution for a short . . nap(S) 

interval, sleep: Suspends execution for an .... sleep(C) 

interval, sleep: Suspends execution for an .... sleep(S) 

swab: Swaps bytes swab(S) 

swap: swap administrative interface . . swap(ADM) 

swapadd: Adds swap area swapadd(S) 

interface swap: swap administrative .... swap(ADM) 

swapadd: Adds swap area .... swapadd(S) 

swab: Swaps bytes swab(S) 

fdswap: Swaps default boot floppy drive. . fdswap(ADM) 

software modifications to the/ swconfig: produces a list of the . . swconfig(C) 

sxt: Pseudo-device driver. .... sxt(M) 

syms: common object file symbol table format syms(F) 

unistd: file header for symbolic constants umstd(F) 

sdb: Invokes symbolic debugger sdb(CP) 

strip: Removes symbols and relocation bits. . . . strip(CP) 

table format syms: common object file symbol . syms(F) 

sync: Updates the super-block. . . sync(ADM) 

sync: Updates the super-block. . . sync(S) 

data segment, sdenter, sdleave: Synchronizes access to a shared . sdenter(S) 

sdgetv, sdwaitv: Synchronizes shared data access. . sdgetv(S) 

select: synchronous I/O multiplexing. . . select(S) 

Checks C language usage and syntax, lint: lint(CP) 

command interpreter with C-like syntax, csh: Invokes a shell . . . csh(C) 

administration utility, sysadmsh: Menu driven system . . sysadmsh(ADM) 

parameters sysdef: output values of tunable . . sysdef(ADM) 

Sends system error/ perror, sys_errlist, sys_nerr, ermo: . . . perror(S) 

sysfiles: Format of UUCP Sysfiles file sysfiles(F) 
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Sysfiles file, sysfiles: Format of UUCP .... sysfiles(F) 

functions. sysi86: machine specific .... sysi86(S) 

error/ perror, sys_errlist, sys_nerr, ermo: Sends system . . perror(S) 

Automatically boots the system, autoboot: autoboot(ADM) 

Gets name of current XENIX system, uname: uname(S) 

commands on a remote XENIX system, remote: Executes .... remote(C) 

config: Configures a XENIX system config(ADM) 

cu: Calls another XENIX system cu(C) 

file systems and shuts down the system, /reboot: Closes out the . . haltsys(ADM) 

mkfs: Constructs a file system mkfs(ADM) 

mount: Mounts a file system mount(S) 

the lineprinter spooling system. Ipadmin: Configures . . . lpadmin(ADM) 

the name of the current XENIX system, uname: Prints uname(C) 

umount: Unmounts a file system umount(S) 

who: Lists who is on the system who(C) 

sar: sar, sal, sa2, sadc system activity report/ sar(ADM) 

uconfig: system hardware changing . . . uconfig(ADM) 

uconfig: changing system hardware uconfig(ADM) 

procedures brc: brc, bcheclcrc system initialization brc(ADM) 

information file cardjnfo: system tty controller card .... card_info 

map file xprtab: system tty transparent printer . . . xprtab(F) 

identification file, systemid: The Micnet system . . . systemid(F) 

- moimt, unmount multiple file systems AnountaU, umountall . . mountall(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

labelit: provide labels for file systems labelit(ADM) 

rep: Copies files across XENIX systems rcp(C) 

Aeboot: Closes out the file systems and shuts down the/ . . . hiltsys(ADM) 

systems: Format of UUCP Systems file systems(F) 

file, systems: Format of UUCP Systems systems(F) 

scsi: SmaU computer systems interface scsi(HW) 

checklist: List of file systems processed by fsck checklist(F) 

device, systty: System maintenance . . . systty(M) 

Format of mounted file system table, mnttab: mnttab(F) 

chrtbl: create a ctype locale table chrtbl(M) 

create a collation locale table coltbl: coltbl(M) 

curtbl: create a currency locale table curtbl(M) 

for flaws and creates bad track table, badtrk: Scans fixed disk . . badtrk(ADM) 

numtbl: Create a numeric locale table numtbl(M) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

syms: common object file symbol table format syms(F) 

NIC database into chaimel/domain tables nictable: process nictable(ADM) 

hdestroy: Manages hash search tables, hsearch, hcreate hsearch(S) 

tables: MMDF Name Tables tables(F) 

term: Terminal driving tables for nroft term(F) 

tables: MMDF Name Tables . . . tables(F) 

tabs: set tabs on a terminal tabs(C) 

tabs: set tabs on a terminal .... tabs(C) 

ctags: Creates a tags file ctags(CP) 

a file, tail: Delivers the last part of ... tail(Q 

Performs/ sin, cos, tan, asin, acos, atan, atan2: .... trig(S) 

functions, sinh, cosh, tanh: Performs hyperbolic .... sinh(S) 
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otar: original tape archive command otar(C) 

tape device tapecntl: AT&T tape control for QIC-24/QIC-02 . . tapecntl(C) 
tape control for QIC-24/QIC-02 tape device tapecntl: AT&T . . . tapecntl(C) 

scsinfo: display current SCSI tape drive information scsinfo(ADM) 

backup: Incremental dump tape format backup(F) 

program, tape: Magnetic tape maintenance . tape(C) 
tape: Magnetic tape maintenance program. . . . tape(Q 

tapedump: Dumps magnetic tape to output file tapedump(C) 

QIC-24/QIC-02 tape device tapecntl: AT&T tape control for . . tapecntl(C) 
output file, tapedump: Dumps magnetic tape to tapedump(C) 

tar: archive format tar(F) 

tar: Archives files tar(Q 

search trees, tsearch, tfind, tdelete, twalk: Manages binary . . tsearch(S) 
tee: Creates a tee in a pipe. . . . tee(C) 

tee: Creates a tee in a pipe tee(Q 

4014: paginator for the TEKTRONIX 4014 temiinal . . . 4014(Q 

last logins of users and teletypes last: Indicate last(C) 

temporary file, tmpnam, tempnam: Creates a name for a . . tmpnam(S) 

print and/or restrict privileges temporarily privs: privs(Q 

tempnam: Creates a name for a temporary file, tmpnam, .... tmpnam(S) 

tmpfile: Creates a temporary file tmpfile(S) 

specified cleantmp: remove temporary files in directories . . . cleantmp(ADM) 
fornrofC term: Terminal driving tables . . . term(F) 
"terminfo/" captoinfo: convert a termcap description into a .... captoinfo(ADM) 
database, termcap: Terminal capability . . . termcap(M) 

Generates a filename for a terminal, ctermid: ctermid(S) 

a printer attached to the user's terminal Iprint: Print to lprint(C) 

ct: spawn getty to a remote terminal ct(C) 

for the 5620 DMD terminal /object downloader . . . wtinit(ADM) 

host control of windowing terminal jagent: jagent(M) 

isatty: Finds the name of a terminal, ttyname ttyname(S) 

jterm: reset layer of windowing terminal jterm(C) 

lock: Locks a user's terminal lock(C) 

of the DASI 450 terminal /special functions . . . 450(C) 

or denies messages sent to a terminal, mesg: Permits mesg(C) 

paginator for the TEKTRONIX 4014 tenminal 4014: 4014(C) 

stty: Sets the options for a terminal stty(C) 

tabs: set tabs on a terminal tabs(C) 

terminal: Login terminal terminal(HW) 

termcap: Terminal capability data base. . . termcap(M) 
"terminfo:" terminal capability data base. . . . terminfo(M) 
"terminfo:" terminal description database. . . terminfo(S) 
nrofif. term: Terminal driving tables for ... . term(F) 

greek: select terminal filter greek(C) 

tgetstr, tgoto, tputs: Performs terminal functions, /tgetflag, . . . termcap(S) 

termio: General terminal interface termio(M) 

termios: POSIX general terminal interface termios(M) 

tty: Special terminal interface tty(M) 

dial: Establishes an out-going terminal line connection dial(S) 

terminal: Login terminal terminal(HW) 

tset: Sets terminal modes tset(C) 
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clear: Qears a terminal screen clear(C) 

"gettydefs: Speed and" .... terminal settings used by gettv. 

ismpx: return windowing terminal state ismpx(C) 

line discipline uugetty: set terminal type, modes, speed, and . uugetty(ADM) 

line discipline, getty: Sets terminal type, modes, speed, and . getty(M) 

used between host and windowing terminal under layers: protocol . . layers(M) 

functions of Hewlett-Packard terminals hp: handle special . . . hp(C) 

layer multiplexer for windowing terminals layers: layers(Q 

of DASI 300 and 300s terminals /special functions . . . 300(Q 

terminals: List of supported terminals terminals(M) 

tty driver for AT&T windowing terminals xt: multiplexed .... xt(HW) 

enable: Hims on terminals and line printers enable(Q 

disable: TXims off terminals and printers disable(C) 

inittab: Alternative login terminals file inittab(F) 

terminals, terminals: List of supported . . . terminals(M) 

tty: Gets the terminal's name tty(Q 

for a child process to stop or terminate, wait: Waits wait(S) 

exit, _exit: Terminates a process exit(S) 

kiU: Terminates a process kill(C) 

shutdown: Terminates all processing shutdown(ADM) 

exit: Terminates the calling process. . . exit(DOS) 

for audit subsystem activation, termination, /command interface . auditcmd(ADM) 

tic: "Terminfo compiler." 

tput: Queries the "terminfo database." 

a termcap description into a "terminfo description" /convert 

infocmp: compare or print out "terminfo descriptions" 

"terminfo: Format of compiled" 

"terminfo file." "terminfo: Format 

database, "terminfo: terminal capability" 

database, "terminfo: terminal description" 

interface, termio: General terminal .... termio(M) 

interface, termios: POSIX general terminal . tennios(M) 

kbmode: Set keyboard mode or test keyboard support kbmode(ADM) 

test: Tests conditions test(C) 

test: Tests conditions test(C) 

ed: Invokes the text editor. ed(C) 

ex: Invokes a text editor. ex(C) 

casual users) edit: text editor (variant of ex for ... edit(Q 

newform: Changes the format of a text file newform(C) 

diff: Compares two text files difB^C) 

fspec: format specification in text files fspec(F) 

plock: Lock process, text, or data in memory plock(S) 

binary search trees, tsearch, tfind, tdelete, twalk: Manages . . tsearch(S) 

tgetstr, tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, .... termcap(S) 

Performs/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: . . . tenncap(S) 

tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, tgetstr, .... termcap(S) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs/ . . termcap(S) 

/tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs terminal/ . . termcap(S) 

tic: Terminfo compiler tic(C) 

Executes commands at a later time, at, batch: at(C) 

Sets up an environment at login time, profile: profile(M) 
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stime: Sets the time. stiine(S) 

time, ftime: Gets time and date. . . time(S) 

Sets the system rcal-time (time of day) clock, setclock: . . setclock(ADM) 

clock: The system real-time (time of day) clock clock(F) 

Executes commands at specified times, cron: cron(Q 

Gets process and child process times, times: times(S) 

file access and modification times, utime: Sets utime(S) 

process data and system/ timex: time a command; report . . timex(ADM) 

time zone timezone: set default system . . . timezone(F) 

file, tmpfile: Creates a temporary . . . tmpfile(S) 

for a temporary file, tmpnam, tempnam: Creates a name tmpnam(S) 

^sascii, tolower, toupper, toascii: Classifies or converts/ . . ctype(S) 

conv, touRjer, tolower, toascii: Ttanslates characters. . . conv(S) 



characters, conv, toupper, tolower, toascii: Translates .... conv(S) 

Asgraph, iscntrl, isascii, tolower, toupper, toascii:/ .... ctype(S) 

topology files, top, top.next: The Micnet .... top(F) 

files, top, top.next: The Micnet topology . . top(F) 



tsort: Sorts a file topologically . tsort(CP) 

top, top.next: The Micnet topology files top(F) 

acctmerg: merge or add total accounting files acctmerg(ADM) 

modification times of a file, touch: Updates access and .... touch(C) 

iscntrl, isascii, tolower, toupper, toascii: Classifies or/ . . ctype(S) 

Translates characters, conv, toupper, tolower, toascii: .... conv(S) 

tplot: graphics filters tplot(ADM) 

database, tput: Queries the terminfo .... tput(C) 

/tgetflag, tgetstr, tgoto, tputs: Performs terminal/ .... termcap(S) 

tr: TYanslates characters tr(C) 

strace: Prints STREAMS trace messages strace(ADM) 

and print xt driver packet traces xtt: extract xtt(ADM) 

ptrace: Traces a process ptrace(S) 

disk for flaws and creates bad track table. /Scans fixed .... badtik(ADM) 

queue files for storing mail in transit queue: MMDF queue(ADM) 

trchan: Translate character sets trchan(M) 

one format to another translate: Translates files from . . translate(C) 

conv, toupper, tolower, toascii: Translates characters conv(S) 

tr: IVanslates characters tr(C) 

to another translate: Translates files from one format . . translate(C) 

setmode: Sets translation mode setmode(DOS) 

decode a binary file for transmission via mail uudecode: . uuencode(C) 

encode a binary file for transmission via mail uuencode: . uuencode(C) 

xprsetup: transparent printer setup utility . . xprsetup(ADM) 

file xprtab: system tty transparent printer map xprtab(F) 

line command xprcat: transparent printer over modem . xprcat(C) 

the scheduler for the uucp file transport program uusched: . . . uusched(ADM) 

trchan: Translate character sets . . trchan(M) 

ftw: Walks a file tree ftw(S) 

twalk: Manages binary search trees, tsearch, tfind, tdelete, . . . tsearch(S) 

acos, atan," atan2: Performs trigonometric functions, /asm, . . trig(S) 

tcbck: trusted computing base checker . tcbck(ADM) 

i386 - get processor type truth value machid: machid, . . . machid(C) 

with debugging on uutry: try to contact remote system . . . uutry(ADM) 
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Manages binary search trees, tsearch, tfind, tdelete, twalk: . . . tsearch(S) 

tset: Sets terminal modes tset(Q 

topologically. tsort: Sorts a file tsort(CP) 

information file cardjnfo: system tty controller card card_info 

mapchan: Configure tty device mapping mapchan(M) 

mapchan: Format of tty device mapping files mapchan(F) 

terminals xt: multiplexed tty driver for AT&T windowing . . xt(HW) 

tty: Gets the terminal's name. . . tty(Q 

tty: Special terminal interface. . . tty(M) 

file xprtab: system tty transparent printer map . . . xprtab(F) 

monochrome, ega,. screen: tty [01 -n], color, screen(HW) 

tty2[a-h],tty2[A-H]:/ ttyl[a-h] , ttyl[A-H] , serial(HW) 

tty2[A-H]: Interface/ ttyl[a-h] ttyl[A-H] ,tty2[a-h] serial(HW) 

tty2[A-H]:/ ttyl[a-h] , ttyl[A-H] ,tty2[a-h] serial(HW) 

hiterface/ ttyl[a-h] ,ttyl[A-H] tty2[a-h] . tty2[A-H]: serial(HW) 

to/ ttyl[a-h] ,ttyl[A-H] , tty2[a-h] , tty2[A-H]: Interface . . serial(HW) 

/,ttyl[A-H] ,tty2[a-h] , tty2[A-H]: Interface to serial/ . . serial(HW) 

ports. /, tty 1[A-H] ,tty2[a-h] tty2[A-H]: Interface to serial . . . serial(HW) 

of a terminal, ttyname, isatty: Finds the name . . ttyname(S) 

utmp file of the current user, ttyslot: Finds the slot in the . . . ttyslot(S) 

attempts to set value of a tunable parameter idtune: .... idmne(ADM) 

sysdef: output values of tunable parameters sysdef(ADM) 

system/ /adjusts tunable parameters to match . . . idmemtune(ADM) 

when adding more memory tunable paramters to be adjusted . memtune(F) 

Aunacct, shutacct, startup, tumacct - shell procedures for/ . . acctsh(ADM) 

printers, disable: "nims off terminals and disable(C) 

accton: Turns on accounting accton(ADM) 

printers, enable: Turns on terminals and line . . . enable(0 

trees, tsearch, tfind, tdelete, twalk: Manages binary search . . tsearch(S) 

dtype: Determines disk type. dtype(C) 

file: Determines file type file(C) 

getty: Sets terminal type, modes, speed, and line/ . . . getty(M) 

uugetty: set terminal type, modes, speed, and line/ . . . uugetty(ADM) 

machid, 1386 - get processor type truth value machid: .... machid(C) 

types: Primitive system data types types(F) 

types, types: Primitive system data . . . types(F) 

variable. TZ: Time zone environment . . . tz(M) 

/localtime, gmtime, asctime, tzset: Converts date and time to/ . ctime(S) 

uadmin: administrative control . . uadmin(ADM) 

uadmin: administrative control. . . uadmin(S) 

limits, ulimit: Gets and sets user .... ulimit(S) 

characters, ultoa: Converts numbers to ... ultoa(DOS) 

creation mask, umask: Sets and gets file .... umask(S) 

mask, umask: Sets file-creation mode . . umask(Q 

structure, umount: Dismounts a file .... umount(ADM) 

umount: Unmounts a file system. . umount(S) 

multiple/ mountall: mountall, umountall - mount, unmount . . . mountall(ADM) 

XENIX system, uname: Gets name of current . . . imame(S) 

current XENIX system, uname: Prints the name of the . . uname(C) 

uncompress: Uncompress a stored file compress(C) 

file, uncompress: Uncompress a stored . compress(C) 
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file, unget: Undoes a previous get of an SCCS unget(CP) 

an sees file, unget: Undoes a previous get of . . unget(CP) 

into input stream, ungetc: Pushes character back . . ungetc(S) 

the console buffer, ungetch: Returns a character to . . ungetch(DOS) 

seed48, lcong48: Generates uniformly distributed. srand48, . . drand48(S) 

configuration/ upsconfig: uninterruptible power supply . . . upsconfig(ADM) 

a file, uniq: Reports repeated lines in . . uniq(Q 

hostid: print imique hardware ID hostid(ADM) 

mktemp: Makes a unique filename mktemp(S) 

constants unistd: file header for symbolic . . unistd(F) 

units: Converts units units(C) 

imits: Converts units units(C) 

backup: performs UNIX backup fionctions backup(ADM) 

for boards uconfig: UNIX configuration manager . . . uconfig(ADM) 

volcopy: make literal copy of UNIX file system volcopy(ADM) 

optimal access time dcopy: copy UNIX filesystems for dcopy(ADM) 

filesystem backup/ restore: AT&T UNIX incremental restore(ADM) 

link_unix: builds a new UNIX system kernel link_unix(ADM) 

^rfdc, prfsnap, prfpr - UNIX system profiler profiler(ADM) 

^rfstat, prfdc, prfsnap, pripr UNIX system profiler profiler(ADM) 

fs: file system - format of UNIX system volume fs(F) 

link: link, unlink: link and unlink files and directories .... link(ADM) 

and directories link: link, unlink: link and unlink files . . . link(ADM) 

unlink: Removes directory entry. . unlink(S) 

reading or/ locking: Locks or unlocks a file region for locking(S) 

Mountall, umountall - mount, unmount multiple file systems . . mountall(ADM) 

umount: Unmounts a file system umount(S) 

files, pack, peat, unpack: Compresses and expands . pack(Q 

Performs linear search and update. Isearch, Ifind: Isearch(S) 

idinstall: add, delete, update, or get device driver/ . . . idinstall(ADM) 

times of a file, touch: Updates access and modification . touch(C) 

of programs, make: Maintains, updates, and regenerates groups . make(CP) 

sync: Updates the super-block sync(ADM) 

sync: Updates the super-block sync(S) 

Converts lowercase characters to uppercase, strupr: strupr(DOS) 

lowercase, strlwr: Converts uppercase characters to ..... strlwr(DOS) 

utility upsconfig: UPS shutdown configuration . . . upsconflg(ADM) 

about system activity, uptime: Displays information . . . uptime(Q 

du: Summarizes disk usage du(C) 

lint: Checks C language usage and syntax lint(CP) 

clock: Reports CPU time used clock(S) 

keystrokes usemouse: Maps mouse input to . usemouse(C) 

Gets the login name of the user, cuserid: cuserid(S) 

hello: Send a message to another user. hello(ADM) 

in the utmp file of the current user, ttyslot: Finds the slot . . . ttyslot(S) 

logname: Finds login name of user. logname(S) 

the user a super-user or another user, su: Makes su(Q 

write: Writes to another user. write(C) 

user, su: Makes the user a super-user or another . . . su(Q 

password/ addxusers: add new user accounts given a XENIX-style addxusers(ADM) 

setuid, setgid: Sets user and group IDs . setuid(S) 
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id: Prints user and group IDs and names. . . id(Q 

names id: print user and group IDs and id(ADM) 

"crontab:" user crontab file crontab(Q 

/getgid, getegid: Gets real user, effective user, real/ getuid(S) 

environ: The user environment environ(M) 

generate disk accounting data by user ID diskusg: diskusg(ADM) 

getpw: Gets password for a given user ID getpw(S) 

newgrp: Logs user into a new group newgrp(Q 

ulimit: Gets and sets user limits. , ulimit(S) 

file maildelivery: user mail delivery specification . maildelivery(F) 

group/ /Gets real user, effective user, real group, and effective . . getuid(S) 

editor (variant of ex for casual users) edit: text edit(C) 

finger: Finds information about users finger(Q 

idleout: Logs out idle users idleout(ADM) 

wall: Writes to all users wall(ADM) 

last: Indicate last logins of users and teletypes last(Q 

lock: Locks a user's terminal lock(C) 

to a printer attached to the user's terminal Iprint: Print . . . lprint(C) 

statistics, ustat: Gets file system ustat(S) 

Menu driven audit administration utility auditsh: auditsh(ADM) 

at and cron administration utility atcronsh: Menu driven . . atcronsh(ADM) 

driven backup administration utility backupsh: Menu backupsh(ADM) 

driven system administration utility, sysadmsh: Menu .... sysadmsh(ADM) 

Ip print service administration utility Ipsh: Menu driven .... Ipsh(ADM) 

mscreen: Serial multiscreens utility mscreen(M) 

STREAMS configuration utility for networking products . . strmcfg(ADM) 

policy file of the sanitization utility purge(Q purge: the .... purge(F) 

modification times, utime: Sets file access and .... utime(S) 

utmp, wtmp: Formats of utmp and wtmp entries utmp(F) 

endutent, utmpname: Accesses utmp file entry getut(S) 

ttyslot: Finds the slot in the utmp file of the current user. . . . ttyslot(S) 

wtmp entries, utmp, wtmp: Formats of utmp and . utmp(F) 

entry, endutent, utmpname: Accesses utmp file . . getut(S) 

uuchat: dials a modem dial(ADM) 

directories and permissions/ uucheck: check the uucp .... uucheck(ADM) 

for woric. uucico: Scan the spool directory . uucico(C) 

clean-up uuclean: uucp spool directory . . uuclean(ADM) 

submit remote mail received via UUCP rmail: nnail(ADM) 

Administers UUCP control files, uuinstall: . . uuinstall(ADM) 

devices: Format of UUCP devices file devices(F) 

file, dialcodes: Format of UUCP dial-code abbreviations . . dialcodes(F) 

dialers: Format of UUCP Dialers file dialers(F) 

file uucheck: check the uucp directories and permissions . uucheck(ADM) 

uusched: the scheduler for the uucp file transport program . . . uusched(ADM) 

maxuuscheds: UUCP Mi«c/ied limit file maxuuscheds(F) 

maxuuxqts: UUCP uuxqt limit file maxuuxqts(F) 

uusub: Monitor uucpnetworic uusub(C) 

permissions: Format of UUCP Permissions file permissions(F) 

poU: Fonnat of UUCP Poll file poll(F) 

uulist: converts a XENIX-style UUCP routing file to/ uulist(ADM) 

uuclean: uucp spool directory clean-up . . uuclean(ADM) 
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control, uustat: uuq) status inquiry and job . • . uustat(Q 

sysflles: Fbimat of UUCP Sysfiles file sysfiles(F) 

systems: Fbnnat of UUCP Systems file systems(F) 

for transmission via mail uudecode: decode a binary file . . uuencode(Q 

for transmission via mail uuencode: encode a binary file . . uuencode(Q 

modes, speed, and line/ uugetty: set terminal type, .... uugetty(ADM) 

files, uuinstall: Administers UUCP control uuinstall(ADM) 

UUCP routing file to/ uulist: converts a XENIX-style . . uulist(ADM) 

file copy, uuto, uupick: Public XENIX-to-XENIX . uuto(C) 

maxuuscheds: UUCP uusched limit file maxuuscheds(F) 

uucp file transport program uusched: the scheduler for the . . uusched(ADM) 

job control, uustat: uucp status inquiry and . . uustat(Q 

uusub: Monitor uucp network. . . uusub(Q 

XENIX-to-XENIX file copy, uuto, uupick: Public uuto(C) 

system with debugging on uutry: try to contact remote . . • uutry(ADM) 

XENIX, uux: Executes command on remote uux(Q 

maxuuxqts: UUCP Mux^f limit file maxuuxqts(F) 

val: Validates an sees file. . . . val(CP) 

val: Validates an sees file val(CP) 

assert: Helps verify validity of program assert(S) 

Returns with a nonzero exit value, false: false(Q 

abs: Returns an integer absolute value abs(S) 

1386 - get processor type truth value machid: machid, machid(C) 

true: Retums with a zero exit value true(e) 

ceil, ftnod: Performs absolute value, floor, ceiling and/ /fabs, . . floor(S) 

getenv: Gets value for environment name. . . . getenv(S) 

labs: Retums the absolute value of a long integer. labs(DOS) 

idtune: attempts to set value of a tunable parameter . . . idtune(ADM) 

putenv: Changes or adds value to environment putenv(S) 

values: machine-dependent values values(M) 

values: machine-dependent values values(M) 

sysdef: output values of tunable parameters . . . sysdef(ADM) 

/Prints formatted output of a varargs argument list vprintf(S) 

varargs: variable argument list. . . varargs(S) 

vdutil: fix a virtual disk vdutil(ADM) 

TZ: Time zone environment variable tz(M) 

varargs: variable argument list varargs(S) 

edit: text editor (variant of ex for casual users) . . edit(C) 

vc: version control vc(C) 

Gets option letter from argument vector, getopt: getopt(S) 

the/ /displays the list of vectors currently specified in . . . vectorsinuse(ADM) 

of vectors currenfly specified/ vectorsinuse: displays the list . . vectorsinuse(ADM) 

display editor, vi, view, vedit: Invokes a screen-oriented . vi(Q 

checkaddr: MMDF address verification program checkaddr(ADM) 

isverify: verifies ISAM database entries . . isverify(M) 

assert: Helps verify validity of program assert(S) 

vc: version control vc(C) 

red: Invokes a restricted version of. red(Q 

sccsdifiE Compares two versions of an SCCS file sccsdiflB^CP) 

formatted output of a/ vprintf, vfjprintf, vsprintf: Prints vprintf(S) 

screen-oriented display editor, vi, view, vedit: Invokes a .... vi(Q 
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a binary file for transmission via mail uudecode: decode . . . uuencode(Q 

a binary file for transmission via mail uuencode: encode . . . uuencode(C) 

submit remote mail received via UUCP rmail: nnail(ADM) 

the font and video mode for a video device, vidi: Sets vidi(C) 

vidi: Sets the font and video mode for a video device. . . vidi(C) 

mode for a video device, vidi: Sets the font and video . . . vidi(C) 

screen-oriented display/ vi, view, vedit: Invokes a vi(Q 

add.vd: add a virtual disic add.vd(ADM) 

vdinfo: virtual disk information utility . . vdinfo(ADM) 

vdutil: virtual disk add vdutil(ADM) 

del.vd: delete a virtual disk del.vd(ADM) 

vdinfo: display virtual disk information vdinfo(ADM) 

vddaemon: virtual disk initialization .... vddaemon(ADM) 

vmstat. Reports virtual memory statistics vmstat(C) 

statistics, vmstat: Reports virtual memory . . vmstat(C) 

UNIX file system volcopy: make literal copy of . . . volcopy(ADM) 

-format of UNIX system volume fs: file system fs(F) 

file system: Format of a system volume filesystem(F) 

Prints formatted output of a/ vprintf, vfprintf, vsprintf: .... vprintf(S) 

output of a/ vprintf, vprintf, vsprintf: Prints formatted .... vprintf(S) 

who is on the system and what w: Displays information about . . w(C) 

background processes, wait: Awaits completion of ... wait(C) 

event ev_block: Wait until the queue contains an . ev_block(S) 

to stop or terminate, wait: Waits for a child process . . wait(S) 

sigsem: Signals a process waiting on a semaphore sigsem(S) 

stop or terminate, wait: Waits for a child process to ... wait(S) 

checks access to a resource/ waitsem, nbwaitsem: Awaits and . waitsem(S) 

ftw: Walks a file tree ftw(S) 

wall: Writes to all users wall(ADM) 

characters, wc: Counts lines, words and . . . wc(0 

whodo: Determines who is doing what whodo(C) 

what, whodo: Determines who is doing . whodo(C) 

jagent: host control of windowing terminal jagent(M) 

jterm: reset layer of windowing terminal jtenn(C) 

ismpx: return windowing terminal state .... ismpx(C) 

/protocol used between host and windowing terminal under .... layers(M) 

layers: layer multiplexer for windowing terminals layers(Q 

multiplexed tty driver for AT&T windowing terminals xt: .... xt(HW) 

Scan the spool directory for woric. uucico: uucico(C) 

Get the pathname of current woiking directory, getcwd: . . . getcwd(S) 

cd: Changes working directory cd(C) 

chdir: Changes the working directory chdir(S) 

pwd: Prints working directory name. .... pwd(C) 

fjputc, fputchar: Write a character to a stream. . . . fputc(DOS) 

write: Writes to a file write(S) 

write: Writes to another user. . . . write(C) 

outp: Writes a byte to an output port. . . outp(DOS) 

console, putch: Writes a character to the putch(DOS) 

putpwent: Writes a password file entry. . . . putpwent(S) 

write: Writes to a file write(S) 

wall: Writes to all users wall(ADM) 
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write: Writes to another user. write(C) 

a file for shared reading and writing, sopen: Opens sopen(DOS) 

a file region for reading or writing. /Locks or unlocks .... locking(S) 

open: Opens file for reading or writing open(S) 

the 5620 DMD terminal wtinit: object downloader for . . . wtinit(ADM) 

utmp, wtmp: Formats of utmp and wtmp entries utmp(F) 

entries, utmp, wtmp: Formats of utmp and wtmp . utmp(F) 

accounting/ fwtmp: fwtmp, wtmpfix: manipulate connect . . . fwtmp(ADM) 

x286emul: emulate XENIX 80286 . x286emul(C) 

commands, xargs: Constructs and executes . . xargs(C) 

incremental filesystem backup, xbackup: Performs XENIX .... xbackup(ADM) 

uux: Executes command on remote XENIX uux(Q 

/add new user accounts given a XENIX-style password file ... addxusers(ADM) 

x286emul: emulate XENIX 80286 x286emul(C) 

Assembler, asx: XENIX 8086/186/286/386 .... asx(CP) 

masm: Invokes the XENIX assembler. masm(CP) 

boot: XENIX boot program boot(HW) 

intro: Introduces XENIX commands Intro(C) 

commands, intro: Introduces XENIX Development System . . Intro(CP) 

Convert 386 COFF files to XENIX format, coffconv: .... coflfconv(M) 

filesystem/ xbackup: Performs XENIX incremental xbackup(ADM) 

system/ xrestore: Invokes XENIX incremental file xrestore(ADM) 

xinstall: XENIX installation shell script . . xinstall(ADM) 

netutil: Administers the XENIX network netutil(ADM) 

Executes commands on a remote XENIX system, remote: .... remote(C) 

Prints the name of the current XENIX system, uname: uname(C) 

config: Configures a XENIX system config(ADM) 

cu: Calls another XENIX system cu(C) 

uname: Gets name of current XENIX system. . uname(S) 

rep: Copies files across XENIX systems rcp(Q 

dosld: XENIX to MS-DOS cross linker. . dosld(CP) 

mmdfalias: converts XENIX-style aliases file to/ ... mmdfalias(ADM) 

to/ mnlist: converts a XENIX-style Micnet routing file . mnlist(ADM) 

file to/ uulist: converts a XENIX-style UUCP routing . . . uulist(ADM) 

uuto, uupick: Public XENIX-to-XENIX file copy. . . . uuto(C) 

shell script xinstall: XENIX installation . . . xinstall(ADM) 

entries from files, xlist, fxlist: Gets name list .... xlist(S) 

programs, xref: Cross-references C xref(CP) 

incremental file system/ xrestore: Invokes XENIX .... xrestore(ADM) 

programs, xstr: Extracts strings from C ... xstr(CP) 

xtt: extract and print xt driver packet traces xtt(ADM) 

xts: extract and print xt driver statistics xts(ADM) 

AT&T windowing terminals xt: multiplexed tty driver for . . . xt(HW) 

channels protocol used by xt(7) driver /multiplexed .... xtproto(M) 

protocol used by x t (7)/ xtproto: multiplexed channels . . xtproto(M) 

statistics xts: extract and print xt driver . . xts(ADM) 

packet traces xtt: extract and print xt driver . . xtt(ADM) 

functions, bessel, jO.jlJn, yO.yl.yn: Performs Bessel . . . bessel(S) 

bessel,jO,jl,jn,yO, yl, yn: Performs Bessel/ bessel(S) 

compiler-compiler, yacc: Invokes a yacc(CP) 

yes: Prints string repeatedly. . . . yes(C) 
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bessel,jO,jl,jn,yO,yl, yn: Performs Bessel functions. . . bessel(S) 

zcat: Display a stored file compress(C) 

true: Returns with a zero exit value true(C) 

set default system time zone timezone: timezone(F) 

TZ:Time zone environment variable. . . . tz(M) 
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Change Information 

This is a summary of the changes that have been made to the previous 
version of this manual. The chapters, page numbers, and/or paragraphs 
mentioned in this summary refer to the previous manual. 

Title: Altos UNIX System V/386 Release 3.2 

System Administrator's Reference (ADM,HW) 

Revised Part Number: 690-23416-002 

Previous Part Numbers: 690-23416-001 and 690-24539-001 

Date: March 1991 



Changes: 

The phrase, "for the 486" (or in some manuals "for Entry-level Sys- 
tems") was deleted to indicate that this operating system runs on a wider 
range of platforms. 

The "Guide to Your Altos UNIX System V/386 Release 3.2 Documenta- 
tion" and the "Operating System Documents for Different Audiences" 
pages located in the front matter of the manual were both changed to indi- 
cate that a different combination of the available manuals are now 
shipped with every run-time system. This has also affected which manu- 
als are now available as spare parts. 

Added add.vd(ADMX addxusers(ADMX checkaddr(ADM), 
checkup(ADM), del.vd(ADM), dlayout(ADM), hdutil{hDM), 
idaddld(ADM), idcheck(ADM), idmemtune(ADM), initscr(ADM), 
strmcfg(ADMX stnntune(ADM), tcbck(ADM), upsconfig(ADM), vddae- 
mon(ADM), xprsetup(ADM), and cdrom(HW). 

Deleted sjTnt(ADM), vdsetup(ADM), vdshut(ADM). 

Miscellaneous editing and typographical changes were made throughout 
the manual. 
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1 add.vd(ADM) No longer asks you for stripe size or default 

number of files to use. This command is nor- 
mally not invoked directly, since the new 
vdutil(ADM) command invokes this com- 
mand. 



1 configure(ADM) Added -o option. Also included small 

changes to main menu display. 



1 crash(ADM) Added -r and -o options, to provide support 

for UPS shutsave requirements. 

1,2 divvy(ADM) Made it clear that the -s option takes as its 

argument the SCSI index number. Also 
emphasized that the -v option takes as its 
argument a partition number, and that it has 
nothing to do with virtual disks. The system 
now supports 52 disks (SCSI index numbers 
0 to 51, and disk letters a to z and A to Z). 



7 divvy (ADM) Also, changed the table in the "SCSI 

Conversion" section to indicate new device 
number allocation scheme. Device numbers 
are allocated on a first-come, first-served 
basis. 



2 fsck(ADM) 



The -rr option is used to recover XENIX root 
hard disks. Added the -b option, which pre- 
forms the same operation for UNIX root 
filesystems. 



2,3 fdisk(ADM) 



Fixed incorrect hard disk device filename. 
Also, minimum recommended size for a 
UNIX partition is now 50 MB, not 40 MB. 



1-3 hdutil(ADM) 



The -c option to move root hard disk device 
names is deleted. Deleted the "Moving the 
Root Disk" section. Also increased range of 
hard disk letters from W up to Z. 
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1,3 mkdev(ADM) Added mkdev graphics option, which some 

systems might not have had documented.' 
Emphasized that mkdev hd does not support 
other controllers besides SCSI, and that 
badtrk is not invoked. Made other miscel- 
laneous mkdev hd corrrections. 



all pcu(ADM) , Added -x option, for attaching transparent 

printers. Summarized the sequence of steps 
to follow when adding a new tty controller to 
the system. All screen labels now have only 
one capital letter, so that they can be 
invoked with a single keystroke (function- 
key substitution). Also described keystroke 
substitutes for arrow-keys. Emphasized that 
the -d and -a options require a space 
between the option and their arguments. 



Disabled ports are displayed with a colon (:) 
preceding their name. Described changes to 
the card_info file that affect pcu, including 
the addition of a new field and distinctions 
between ISA and EISA cards. 



2 scsinfo(ADM) Logical SCSI index numbers for hard disks 

now range from 0 to 51, not 34. Also, logi- 
cal index numbers for SCSI tapes range only 
from 0 to 7, not up to 15. Deleted numbering 
information found in the "Notes" section 
that no longer applies to the current scheme. 

1,2 strmcfg(ADM) Added the -p option. Added another 

configurable parameter, NSTREAM. 
Described data files in the directory, ./config. 

1 swap(ADM) Corrected erroneous hard disk device 

filename. 
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1,2 uconfig(ADM) uconfig now sets up terminal database for 

system security services. Added -t option, to 
suppress setting up protected terminal data- 
base. Made clear all EISA-specific tasks. 

1-2 upsconfig(ADM) Added -i, -t, and -d options. Described the 

added support for UPS shutsave operation. 

1 vddaemon(ADM) Deleted all options; they are no longer 

accepted, vddaemon is always started (by 
init), thus no longer requiring a manual invo- 
cation, vdshut has been deleted. 

Support for both mirror and striped disks has 
been added, for those systems that did not 
have full functionality before. Corrected 
hard disk device filename example. Added 
more examples of typical vdinfo output. 

Numerous changes were made to the vdutil 
functionality and appearance, vdutil is now 
the preferred utility for all virtual disk opera- 
tions. 

Changed the format of the standalone boot 
program, including the addition of new 
parameters. Described how these bootstring 
parameters change meaning depending on 
the exact number of parameters used. Also 
changed the format of additional arguments 
to the bootstring. Added new aliasing infor- 
mation. 

The scm value in the bootstring systty is on 
for the display adapter, not scrn. 



1-2 vdinfo(ADM) 



1-4 vdutil(ADM) 



2-4 boot(HW) 



4 boot(HW) 
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5-6 boot(HW) Replaced old aliasing example with a better 

one. Added two new boot options, RES- 
TART and RSPART, to provide boot sup- 
port for UPS shutsave operations. Also 
added two new command line parameters, 
verbose and restart. 



1-4 hd(HW) Simplified the fomiat description of hard 

disk device filenames. The range of valid 
hard disk "numbers" has increased from W 
to Z. Major numbers for hard disks can now 
range up to 76, not 73. Deleted descriptions 
of old allocation schemes. 
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